Pros & Cons
Basic
Trade-offs
Do
- Fast to implement
- Simple mental model
Avoid
- Limited flexibility
- Potential scaling costs
Highlight a side (neutral tone)
Emphasize Pros
Pros
- Great DX
- Broad ecosystem
Cons
- Learning curve
- Runtime overhead
Highlight tone options
Positive tone (highlight pros):
Pros
- Clear contracts
- Testable modules
Cons
- More boilerplate
- Indirection
Warning tone (highlight cons):
Pros
- High throughput
- Mature libraries
Cons
- Operational complexity
- Harder local dev
Info tone (highlight both):
Pros
- Great for small teams
- Rapid prototyping
Cons
- Risk of tight coupling
- Migration later
Rich content items
Details
Pros
- Supports plugins
- Typed
interfaces
Cons
- Requires governance
- More guidelines to follow