explanation-docs

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.

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 answer "why?" and "how does it work?" rather than "how do I?"

Modelli di documentazione esplicativa per contenuti orientati alla comprensione: guide concettuali che spiegano perché le cose funzionano in un certo modo Fonte: existential-birds/beagle.