Document design is the practice of organizing text, layout, typography, and visual elements so that a document is usable by its intended audience. Document design treats the visual presentation of information as a rhetorical choice, not a cosmetic one.

Karen Schriver established document design on empirical foundations by synthesizing rhetoric, cognitive psychology, and graphic design. Her research demonstrated that headings, whitespace, typeface, and layout shape how readers process content — poor document design can make well-written prose unusable, and good document design can make complex material navigable [@schriver1997].

In this vault, document design operates through:

  • Headings as navigation — the plain language specification requires headings that are specific and useful on their own, functioning as a table of contents. Vague headings like “Overview” or “Information” fail this test.
  • Progressive disclosureindex pages provide orientation before detail. Lessons introduce concrete examples before formal definitions. The structure reveals information at the pace the reader needs it.
  • Lists and tables — the plain language specification prescribes numbered lists for ordered steps and bullet lists for unordered items. Tables are used when readers need to match conditions to outcomes.
  • One purpose per section — each section has one job. When a section answers two questions, it gets split.

Document design in a text-based vault like this one is constrained compared to print or web publishing — there’s no control over typeface, color, or layout beyond what Markdown provides. The available tools are headings, lists, tables, whitespace, and cross-references. Within those constraints, the same principles apply: make the structure visible, let the reader scan before they read, and don’t force them to hold the whole document in memory.

The design module’s visual engineering practices extend document design principles into visual composition. Edward Tufte’s information design shares Schriver’s core concern — that every visual element must earn its cost by contributing to understanding — and formalizes it through the attention-budget discipline and the micro/macro coherence principle. The design module’s typography curriculum develops the visual side of document design in detail: hierarchy, line height, line length, and margins all shape how readers process text.

  • information architecture — IA is the structural dimension of document design
  • progressive disclosure — a document design strategy for managing complexity
  • audience — document design serves the reader’s needs, not the writer’s preferences
  • readability — document design affects readability beyond what sentence-level clarity can achieve
  • accessibility — accessible document design extends to assistive technology and cognitive diversity
  • genre — different genres have different document design conventions
  • cognitive load — good document design reduces extraneous cognitive load through visual structure
  • visual engineering — the design module’s composite discipline that extends document design principles into visual composition