Skip to content

esond/docs

v0.30.0MIT

Eric's documentation skills: Diátaxis-guided writing and auditing of tutorials, how-to guides, reference, and explanation.

diataxis-explanation

Write, expand, or audit explanation — understanding-oriented documentation in the Diátaxis sense: discursive discussion that deepens the reader's grasp of a topic, read away from the work itself. Use whenever the user wants an architecture overview, design-rationale or "why did we build it this way" doc, concept guide, background or theory piece, ADR-style context, a "philosophy of X" or "about X" article, or asks to capture the reasoning behind a decision — even if they never say "explanation". Also loaded by the diataxis router when the compass points to cognition + acquisition: the reader wants to *understand*, as *study*. If the content is facts to consult mid-work, that's diataxis-reference; if it directs a task, that's diataxis-how-to. When the type is in doubt or mixed, consult the diataxis skill first.

Read SKILL.md at the source

Pinned to revision a943fbd893c9, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.