Skip to content
BUILD / 04.0100BUILDINGREAD FIRST

Documentation

One document tree. Concepts, objects, permissions, and the exact wording of every guarantee.

Documentation is written before the surface it documents. If a page cannot be written plainly, the design is wrong and the design changes.

Every object in the world — person, organization, world, document, opportunity, place — has a page describing its fields, its lifecycle, and who may read or change it.

Document tree
docs/
  concepts/       what the world is made of
  objects/        person, organization, world, document
  permissions/    who may read, write, revoke
  limits/         rates, quotas, retention
  changes/        dated diffs of every guarantee
FACTS
FORMAT
Markdown, versioned in the open
VERSIONING
Dated, with a visible diff
SCOPE
Concepts, objects, permissions, limits
REFUSALS
  • No documentation behind a login.
  • No feature shipped before its page exists.
  • No silent edits to a published guarantee.