Skip to content

docs(architecture): align architecture.md with the page standard - #421

Merged
catinspace-au merged 1 commit into
mainfrom
docs/arch-standard
Nov 17, 2026
Merged

catinspace-au merged 1 commit into
mainfrom
docs/arch-standard

Conversation

@catinspace-au

Copy link
Copy Markdown
Contributor

docs/architecture.md is the stack's L2 Services page. Figure 1 draws both ingest services, the source topic, the optional transform and its topic, the loader and archiver, and the console and engine. The gRPC path that skips Kafka is a labelled dotted edge. Figure 1 is 684 px wide.

The page has the standard's sections in order. The Components table has a row per box. The Compose profile table stays because docker-compose.yml points readers at it.

The console origin and the two port 6000 listeners move to operating.md. Their diagrams are redrawn. The engine-rendered config and make apply move to a new docs/per-source-apps.md.

Profile resolution and the start order move to CONTRIBUTING.md's Context section. The page keeps the old anchor that profiles.md links to.

The dev image build in developing.md and the self-telemetry diagram in observability.md use stage rows, at 670 and 844 px respectively.

docs/architecture.md is the stack's L2 Services page. Figure 1 draws both ingest services, the source topic, the optional transform and its topic, the loader and archiver, and the console and engine. The gRPC path that skips Kafka is a labelled dotted edge. Figure 1 is 684 px wide.

The page has the standard's sections in order. The Components table has a row per box. The Compose profile table stays because docker-compose.yml points readers at it.

The console origin and the two port 6000 listeners move to operating.md. Their diagrams are redrawn. The engine-rendered config and make apply move to a new docs/per-source-apps.md.

Profile resolution and the start order move to CONTRIBUTING.md's Context section. The page keeps the old anchor that profiles.md links to.

The dev image build in developing.md and the self-telemetry diagram in observability.md use stage rows, at 670 and 844 px respectively.
@catinspace-au
catinspace-au merged commit 068068a into main Nov 17, 2026
14 checks passed
@catinspace-au
catinspace-au deleted the docs/arch-standard branch November 17, 2026 03:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant