---
title: Pages
topics: [manual]
---

# Pages

A page is the stable home for what the wiki knows about one durable subject.

Good subjects include decisions, subsystems, external services, workflows,
incidents, invariants, failure modes, project strategy, and repeated concepts
that future agents will need again.

Do not create pages that only summarize one file, one transcript, one diff, or
one task log. Those are material used to justify a change. They are not usually
the subject of the wiki.

Prefer updating an existing page when the subject already has a home. Create a
new page when the material reveals a durable subject that would otherwise stay
buried.

Use `[[page-slug]]` links for subjects a reader may follow. Use
`[[src/path.py]]` and `[[src/path/]]` references when a page should be found by
file-aware search.

Page links are for real wiki nodes, not automatic entity markup. Link only to
an existing page or a page created in the same run. If the subject is useful
but does not yet deserve a page, mention it as plain text.
