Skip to content

docs(architecture): sweep every chapter for the chapter style - #2422

Merged
braboj merged 1 commit into
mainfrom
docs/arch-sweep
Oct 31, 2026
Merged

braboj merged 1 commit into
mainfrom
docs/arch-sweep

Conversation

@braboj

@braboj braboj commented Oct 31, 2026

Copy link
Copy Markdown
Collaborator

A sweep of all twelve chapters against the style chapters 6 to 12 settled on, plus the FR-05-01 conflict with the emitter.

# Where Change
1 FR-05-01, 2.1, 4.3 No build step required; the emitter is optional
2 2.3, 2.4, 3.2, 3.3, 10.2 A Source column
3 2.3, 4.1, 5.1, 5.5, 9 "Upstream", not "this repository"
4 3.1 table and diagram "Team" and "Contributor"
5 3.1, 3.2 Every integration model, not only clone or submodule
6 4.2 The forward-looking ADR-058 sentence dropped
7 5.2, 8.1, 8.7 No ":" mid-sentence
8 5.2 Source ADR-050, not "Chapter 8.6"
9 5.3, tools/sync_docs.py Generated core-tier prose without colons or a dash
10 5.2, 5.3 and two diagrams No interview assumed; "coding agent", not "generator"
11 5.5 The docs/tests/ pointer is the lead-in

Diagrams re-exported: context-business, building-blocks-templates, building-blocks-manifest.

Checks run: smoke, markdownlint, sync_docs --check, the doc-figures check, pyflakes.

Closes no issue: part of the architecture chapter review.

No changelog entry: documentation and a generated paragraph only, nothing a consuming project notices.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH

Make the build step optional in FR-05-01 and chapters 2 and 4, add Source
columns to 2.3, 2.4, 3.2, 3.3 and 10.2, call this repository upstream,
shorten chapter 3's role names, list every integration model, and drop the
colons, the forward references and the undefined generator. The generated
core-tier prose loses its colons and dash.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DpT5xSVK2FLNdArtRtNjLH
@braboj
braboj merged commit 607df09 into main Oct 31, 2026
14 checks passed
@braboj
braboj deleted the docs/arch-sweep branch October 31, 2026 11:25
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