๐ Digest: what the genre owes its reader¶
Assumes the core, ยง1โ9 of WRITING-STANDARDS.md. This file holds the writing rules that apply to a verbatim digest alone: what it is for, its paragraph and the drafter's own sentences inside it, its figures and equations, and what its reread looks for. VERBATIM-DIGEST.md is the design and the report that checks a digest; the element rules are in figures.md, mathematics.md and tables.md; this file repeats none of them.
๐ฏ What a digest owes its reader¶
A digest has three goals, in this order:
- A self-sufficient survey the reader can learn the topic from.
- As much of the body as possible in the sources' exact words.
- Surface and minimise unsupported text. The report lists every sentence no source backs; each repair pass leaves fewer.
It must read on its own: someone who has opened none of the papers can follow it from the first page to the last. Name the reader as someone who has read none of the papers, and never assume the reader's own projects, a book they are writing, or a running example from outside the corpus. Every recurring term has one definition the whole digest uses, the glossary's.
Why it may copy at all. The core keeps verbatim wording out of a draft (WRITING-STANDARDS.md ยง9: it has one home, and that home is never the draft). A digest is that home made explicit, with every run attributed where it stands. The rule against passing off a source's wording (SOUL.md) is kept by the citation that closes every run and by the rule that a digest is never a source for drafting anything else.
๐งต The paragraph, and your own sentences in it¶
A digest's unit for multi-source synthesis is the paragraph, as in a survey (WRITING-STANDARDS.md ยง11 states it). Each body paragraph opens with a sentence of yours stating its point, then braids the copied runs that make it, from two or more papers, ordered by the argument, never one paper after another. Organise it around what the sources agree and disagree on; a disagreement is shown with both sides copied and named in a sentence of yours, never resolved silently.
Your own sentences are few and short, and they are there to compare,
contrast or define. They sit between runs, never inside one, and each
makes a point: a sentence that narrates the sources ("the book then
names...") instead of making one is a defect. Define a term at first
use, in the glossary's words, and never write "the book" or "the
tutorial" where the reader cannot tell which. The core's ยง4 binds these
sentences only; for the same reason the dialect scope.md records
governs your sentences alone, since copied text keeps its source's
spelling.
The framing, the gap analysis and the comparison table's phrases are yours too. The gap analysis says what the corpus does not cover, which themes stayed thin, and which disagreement the corpus does not settle.
๐ผ Figures and equations: the sources' own¶
A digest draws no figure. Its figures are the sources', placed beside the run they belong to and captioned in your own words, and like a copied sentence a copied figure never travels into another draft.
Equations are the reverse of a survey's: a digest carries every equation a copied run introduces, uses or explains, typeset in mathematics.md ยง12's mapped form, and never writes one as text. An equation or a symbol of your own is set the same way, so one digest has one way of setting mathematics. Number an equation only if a sentence of yours refers to it.
๐ The reread¶
Read the digest once as someone who has opened none of the papers (WRITING-STANDARDS.md ยง6). In a digest, check specifically for:
- a term or symbol used before it is defined;
- a run that names a figure, equation, section or reference the digest does not show;
- a run that opens on a word pointing back at something not there;
- a paragraph that is one paper after another rather than an argument;
- a sentence of yours that narrates the sources instead of making a point;
- a gap analysis that omits a theme that stayed thin.