Overview
Lead with a tight summary. Highlight key terms inline so the eye lands on them.
Key insight
The single most important takeaway goes here, up top.
🧩
Concept A
One-line definition or role.
⚙️
Concept B
One-line definition or role.
🔌
Concept C
One-line definition or role.
Architecture / flow
Client
→
IngressTLS term
→
ServiceClusterIP
→
Pods
Note
Use --accent nodes to mark the focal point of the diagram.
Tradeoffs / decision
| Option | Pros | Cons | When |
|---|---|---|---|
| Option A ⭐ | ✓ Simple | ✗ Less flexible | Default choice |
| Option B | ✓ Flexible | ✗ More ops | Scale > X |
Recommendation
State the pick and the one-line why.
Detail (progressive)
First approach detail.
Second approach detail.
Edge cases & gotchas
Warning
Failure mode worth calling out.
Longer explanation lives here, out of the way until expanded.
- First
What happens.
- Then
Next step.
- Finally
Outcome.