Skip to content

emergent engineering

The internal engineering site — how to work on emergent, and a rendered view of the whole docs/ tree.

Two layers, one site. The Start here guides are hand-written orientation: getting a dev environment up, a repo tour, and how build and deploy actually work. Everything under Engineering is a generated, read-only view of the repo-canonical docs/ tree — regenerated on every build, so it is exactly as current as the commit that built this site. Edit those pages in docs/ in the repo, never here.

Decisions & architecture

ADRs record the hard-to-reverse choices; architecture holds the reference models.

Operating

Runbooks for the procedures we actually run — migrations, configuration, keys, conformance suites.