You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
06_structurizr.md is 1,278 lines — the single largest chapter in Parts A–B. Structurizr is one tool and does not warrant 1,278 lines.
Specific cuts
06:11–21 — DELETE the off-topic paragraph on the FINOS AaC project (belongs in an ecosystem appendix).
06:23–51 — SHORTEN the C4 intro by 50%; keep the table + one sentence.
06:57–273 — SHORTEN by 60% the Structurizr DSL tutorial (216 lines). Keep one workspace + one container + one view; defer to the official documentation for the rest. It is not the author's job to write a user manual.
06:283–287 — Swap Structurizr Lite (EOL) for Structurizr Local throughout, but later sections still refer to Lite.
06:361–446 — MOVE TO ch. 24 (Team Enablement). 85 lines on "Foundational bootcamps", "Pair-modelling rotations" and "CoP" are not Structurizr-specific.
06:448–494 — MOVE TO an appendix/README. Describes the book's own repo contents (docs/examples/structurizr/...) — distracting.
06:496–634 — SHORTEN: keep the GitHub Actions example, DELETE GitLab CI + PR-validation (same pattern three times).
06:636–783 — Three complete DSL workspaces (Microservices/Event-Driven/Multi-Tenant); KEEP ONE, DELETE the others.
06:872–1000 — SHORTEN by 60% the "10 best practices" down to 4 consolidated practices.
06:1002–1048 — SHORTEN tool comparisons by 60%; one table is enough.
06:1050–1220 — SHORTEN by 70% "Common Challenges" (170 lines, including a 40-line Python validator). Keep Layout Control + Model Sync as concepts; DELETE the code.
06:1254–1268 — SHORTEN the marketing-language summary by 50%.
Suggested split
Consider splitting ch. 6 into:
(a) "Architecture modelling with C4 and Structurizr" — core ~400 lines
(b) Move "Team Enablement" to ch. 24
(c) Move "Comparisons" to an appendix
Expected saving
~640 lines (50%).
Source
Hard critical review of Parts A & B. See CUT_PROPOSAL.md.
Activity
Init draft for issue #1916
[-]Kap 6: halvera Structurizr — överväg uppstyckning (-640 rader)[/-][+]Ch. 6: halve Structurizr — consider splitting (-640 lines)[/+]