iandennismiller / mueller-report Goto Github PK

View Code? Open in Web Editor NEW

54.0 3.0 8.0 78.42 MB

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

Home Page: http://opensourcemuellerreport.com

License: Other

Makefile 0.40% TeX 99.53% Python 0.08%

united-states legal mueller trump russia obstruction mueller-report

mueller-report's Introduction

Open Source Mueller Report

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

Discussion

website: http://opensourcemuellerreport.com
chatroom: https://gitter.im/open-source-mueller-report
forum: https://www.reddit.com/r/OpenSourceMueller

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

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.

mueller-report's People

Contributors

Stargazers

Watchers

Forkers

gitter-badger ascherer totalgood gramasaurous catufunwa abargnesi sguzman crashbandicooch

mueller-report's Issues

Spellcheck

run aspell and add any terms

copy-paste: vol 2, Background Legal and Evidentiary Principles

Source code: src/volume-2/background-principles.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

copy-paster: appendix B

Source code: src/appendix/appendix-b.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

redacter: vol 2, background principles

Source code: src/volume-2/background-principles.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

copy-paste: vol 1, Prosecution and Declination Decisions

Source code: src/volume-1/decisions.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

footnote-adder: vol 2, Factual Results of the Obstruction Investigation

Source code: src/volume-2/factual-results.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

footnote-adder: vol 2, Legal Defenses to the Application of Obstruction-of-Justice Statutes to the President

Source code: src/volume-2/legal-defenses-of-president.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

redacter: vol 2, legal defense of president

Source code: src/volume-2/legal-defense-of-president.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

include "open source" in page footer

goal: each page of the open source report should be immediately distinguishable as a separate document from the original DOJ release.

tweak the footer, which is specified in includes.tex, to include the document title "Open Source Mueller Report"
add text before or after page number, or something...

redacter: vol 2, factual results

Source code: src/volume-2/factual-results.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

copy-paster: appendix D

Source code: src/appendix/appendix-d.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

redacter: vol 1, hacking and dumping

Source code: src/volume-1/hacking-dumping.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

copy-paster: appendix A

Source code: src/apendix/appendix-a.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

smart quotes throughout

LaTeX uses specific markup for quotes. Throughout most of the original DOJ document, quotes are detected as " - and this should be replaced by the LaTeX equivalent.

render Cyrillic font

There are a few instances in the original DOJ document where Cyrillic is used.

need cross-platform font with good Unicode support
or another (XeTeX) solution

footnote-adder: vol 2, Conclusion

Source code: src/volume-2/conclusion.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

continuous integration

Use travis-ci.org to automatically spellcheck and render PDFs

proofer: vol. 1, executive summary

Source code: src/volume-1/executive-summary.tex et. al.

~~Fix non--end-of-sentence fullstop after abbreviations like St.~Petersburg, Trump Jr.\ , and Ms.~Veselnitskaya.~~
Fix end-of-sentence fullstop after abbreviations like DNC\null.

This applies to all parts and source files with such elements.

redacter: vol 1, active measures

Source code: src/volume-1/active-measures.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

footnote-adder: appendix D

Source code: src/appendix/appendix-d.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

footnote-adder: appendix C

Source code: src/appendix/appendix-c.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

footnote-adder: vol 1, hacking and dumping

Source code: src/volume-1/hacking-dumping.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

copy-paste: vol 1, Russian Government Links to and Contacts with The Trump Campaign

Source code: src/volume-1/russian-links-to-trump.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

footnote-adder: vol 2, Background Legal and Evidentiary Principles

Source code: src/volume-2/background-principles.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

copy-paste: vol 2, Executive Summary to Volume II

Source code: src/volume-2/executive-summary.tex

copy and paste all text from source document
manually enter any text that does not copy
use LaTeX document conventions
add blank footnotes using footnote template
add redactions using redaction template

copy-paste: vol 2, Introduction to Volume II

Source code: src/volume-2/introduction.tex

copy and paste all text from source document
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template
use LaTeX document conventions

copy-paste: vol 2, Factual Results of the Obstruction Investigation

Source code: src/volume-2/factual-results.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

Images in volume 1

This issue is the catch-all for images in Volume 1
Throughout the document, a few images are included as exhibits:

p. 31: coal miners poster
p. 34: trump facebook account
p. 86: meeting of foreign policy team
p. 91: Papadopolous and Clovis
p. 92: Papadopolous notes

redacter: appendix d

Source code: src/appendix/appendix-d.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

redacter: vol 1, special counsel investigation

Source file is src/volume-1/investigation.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

redacter: appendix A

Source code: src/appendix/appendix-a.tex

locate redacted portions and adjust length of redacted passage to match the DOJ document
copy-paste from lorem ipsum text, as appropriate

Lorem ipsum text

footnote-adder: vol 1, active measures

Source code: src/volume-1/active-measures.tex

read the Contributing guide
add blank footnotes using footnote template
copy and paste footnotes from the source document
manually enter any text that does not copy
add redactions using redaction template
use LaTeX document conventions

footnote-adder: appendix B

Source code: src/appendix/appendix-b.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

footnote-adder: vol 1, Russian Government Links to and Contacts with The Trump Campaign

Source code: src/volume-1/russian-links-to-trump.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

copy-paste: vol 2, Conclusion

Source code: src/volume-2/conclusion.tex

copy and paste all text from source document
use LaTeX document conventions
manually enter any text that does not copy
add blank footnotes using footnote template
add redactions using redaction template

indentation is incorrect for subheadings in table of contents

Each sub-heading is progressively indented ever-farther - and this is too far.

footnote-adder: vol 2, Executive Summary to Volume II

Source code: src/volume-2/executive-summary.tex

copy and paste footnotes from the source document
use LaTeX document conventions
manually enter any text that does not copy
add redactions using redaction template

redacted headings

We need a good solution for adding redacted headings.
There are several current problems with redacted headings.

the censor package \blackout tag does not work in a section heading
the Unicode black box is not supported by all fonts
current headings show up as either empty boxes or as blank space, depending on the font

Possible solutions: