Skip to content

Latest commit

 

History

History
114 lines (81 loc) · 5.71 KB

Readme.md

File metadata and controls

114 lines (81 loc) · 5.71 KB

Open Source Mueller Report

Open Source Mueller Report is an enhanced edition of the Mueller Report.

Website GitHub contributors Build Status GitHub issues Gitter Subreddit

Discussion

Features

  • high fidelity text; not deteriorated by photocopy, redaction, and optical character recognition
  • available in PDF and ePub formats
  • supports full-text search
  • split document into Volume 1 and Volume 2
  • PDF page numbering matches content page numbering
  • descriptive page headers with section name
  • working hyperlinks for table of contents and footnotes
  • redactions are represented explicitly in the source code
  • reduced file size (under 5 MB)
  • canonical URL with greater permanence than DOJ distribution

Limitations

  • under development; not complete yet
  • might include typos and other errors; please help if you find anything!
  • page numbers do not correspond to original Mueller document or to DOJ release
  • redacted boxes are interrupted by spaces; they are not continuous
  • redacted boxes, which are based on lorem ipsum text, are suggestive of underlying word length and structure although no information about this is known
  • other cosmetic differences

Motivation

The U.S. Department of Justice (DOJ) released a redacted version of the Mueller Report on April 18, 2019. The DOJ release suffers from technical limitations that interfere with public discussion about the Mueller investigation. For example:

  • the DOJ PDF cannot be searched
  • passages of text in the DOJ PDF cannot be highlighted or copied-and-pasted
  • the table of contents in the DOJ PDF is not "clickable"
  • the page numbers in the footer do not match the DOJ PDF page numbers
  • the DOJ PDF appears to be derived from an optically-scanned copy and, consequently, there are visual artifacts in the PDF
  • the DOJ PDF is a large file (137 MB)

Open Source Mueller Report is an effort to correct those technical limitations by providing a "clean room" reimplementation of the document from source code.

Contributing

The document is written with LaTeX. If you know a little bit of LaTeX and you know how to use Github, then you can help with the project. There are several kinds of helper roles that enable collaborative editing of the document.

Helper roles

  • redacter: adjust length of redacted boxes to be comparable to the original
  • proof reader: fix typographic errors, spelling, and other mistakes
  • LaTeX guru: tweak includes.tex to make the document look like the original while providing enhanced functionality
  • copy-paster: locate a section heading and copy-paste text from the PDF
  • footnote adder: add footnotes and fill them with content from the PDF

How to Contribute

Learn how to help on the Contributing page.

Build Instructions

The document can be rendered with TeX Live and MacTeX.

cd src && make all

The results will be written to docs/products.

Debian/Ubuntu Requirements

Ensure the following packages are installed.

apt install aspell texlive-xetex latexmk

See also

License

Open Source Mueller Report

(CC) 2019 Ian Dennis Miller

Attribution 3.0 Unported (CC BY 3.0)

https://creativecommons.org/licenses/by/3.0/

You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.