Reference
Last updated: 08/21/20261 min read
This part contains no argument. It is a place to look things up: the meaning of a word, how to report a vulnerability, short answers to common questions, and the record of one contribution.
| Page | Use it when |
|---|---|
| Glossary | You meet an unfamiliar word, or suspect you and the writer mean different things by it |
| Security and disclosure | You found a vulnerability, or want to know how far the project has been audited |
| FAQ | You need a short answer, and a link to where it is discussed properly |
| Appendix — The first submission | You want to see how one person filled in this document's empty boxes |
Figure 29 — Four reference doors, chosen by the shape of the question.
One convention of the whole document, repeated here because reference pages are the most skimmed: every claim in this document carries exactly one of four labels — ENGRAVED, RUNNING, PROPOSED, LEFT BLANK — defined in Before you read. Anything not marked ENGRAVED can be changed.
In short: a document without a reference section forces readers to read all of it before they can use any of it — and most readers will not read all of it.