comments-and-documentationlisted

# Comments And Documentation Source carries the minimum that conveys the contract. Past that, every line is a liability: it goes stale, and once a reader catches one line lying they stop trusting the rest. Two forms, two jobs: - [Comments](references/comments.md) label. A comment names what the code is, in one line, where the code can't name itself. - [Documentation](references/documentation.md) states the contract. What a caller passes, what comes back, what can go wrong. Read the reference for whichever form the diff touches. Read both when it touches both. ## The Procedure List every comment and every documentation block the diff touches, with its line count, including the ones the diff already carried and not only the ones you wrote. Toolchain directives are the one exemption, and `references/comments.md` says which. Give each remaining entry exactly one disposition: - `label, kept`: A one-line comment naming what the code is. - `contract, kept`: Documentation already at the contract and no larger. - `trimmed`: Documentation cut down to the contract. - `moved to <path>`: Rationale, whose content now lives in a reference file and is gone from the source. - `deleted`: It restated the code, so the code already says it and nothing needs to survive. There is no sixth disposition. "Kept, because it explains something the code can't" is not one of these, and writing that sentence means the check did not run. An entry you never listed is an entry you never checked. ## Ra