On this page

Make the structure visible

Readers should be able to tell where they are, what belongs together, and what they can read next. Navigation is part of the argument.

Prefer a useful distinction

We use Sections for the kind of work an article is doing and Topics for the subjects it touches. The distinction is modest, but it keeps the archive from becoming a flat list.

Keep claims close to their evidence

When a statement depends on a source, method, or definition, we identify that dependency. We would rather leave a question open than make a smooth sentence carry more certainty than the material allows.

Treat maintenance as editorial work

Labels, URLs, templates, metadata, and release notes are not backstage details. They determine whether a document can be found, understood, and trusted later.