Sequence diagrams

Flows that span several actors or systems, run asynchronously or retry, such as the build and search sync.

Flows that span actors or systems, run asynchronously, or retry — the build and search sync, docs generated from a package's source, deploys.

Living snapshots. Edit in place so each file describes the system as it is right now. No revision tables, no "previously X, now Y" — delete what is no longer true (ADR-0002).

Conventions

File name: <flow>.mdx.
Mermaid sequenceDiagram with autonumber, then failure paths (step, failure, behaviour, recovery) and post-conditions.

Template: ../_templates/sequence.mdx

Documents

Document	Status	ADR
Build and search sync	Current	— (Fumadocs scaffold)

DFD — System (Level 0)

The whole site as one data flow, from authoring through the build and publishing to reading, with its trust boundaries.

Sequence — Build and search sync

What happens when the site is built and published: next build runs, then every page's search record is pushed to Algolia.

On this page

Conventions
Documents