Chapter template (shared)¶
Copy this scaffold when writing a new content chapter (N.1 and up in Parts 1 through 11). Replace the bracketed guidance. Keep the section order exactly. Do not use em-dashes. Define terms on first use and link key concepts to Wikipedia.
# N.M Title
## Overview and motivation
[Two or three short paragraphs: what this is, why it matters for large teams, and
why it matters in enterprise and government settings. Warm, direct, plain.]
## Key principles
- [Short, memorable principle.]
- [Short, memorable principle.]
## Recommendations
### [First recommendation as an imperative]
[Concrete, practical guidance.]
### [Second recommendation]
[Concrete, practical guidance.]
## Trade-offs: pros and cons
| Approach | Pros | Cons |
| --- | --- | --- |
| [Option] | [Upside] | [Downside] |
[A paragraph on the central tension and how to resolve it.]
## Examples
**Enterprise.** [A concrete, realistic enterprise scenario.]
**Government.** [A concrete, realistic public-sector scenario.]
## Business case: motivations, ROI, and TCO
[Return on investment, total cost of ownership, and the cost of not doing this.
How to make the case to leadership.]
## Anti-patterns and pitfalls
- [Anti-pattern, with a short reason it hurts.]
## Maturity model
- **Level 1, Initial:** [what this looks like]
- **Level 2, Managed:** [what this looks like]
- **Level 3, Defined:** [what this looks like]
- **Level 4, Optimizing:** [what this looks like]
## Ideas for discussion
1. [Open question a team could debate.]
## Key takeaways
- [The one or two things to remember.]
## References and further reading
- [Author, *Title*. Real works only. No fabricated URLs.]