Explanation documentation patterns for understanding-oriented content - conceptual guides that explain why things work the way they do
This skill provides patterns for writing effective explanation documents. Explanations are understanding-oriented content for readers who want to know why things work the way they do.
Target readers:
Explanations are for reading away from the keyboard. Unlike tutorials or how-to guides, readers aren't trying to accomplish a task while reading. They're building mental models.
Explanations are NOT:
Use this structure for all explanation documents:
---