name	diataxis-documentation
description	Apply the Diataxis framework: identify which of the four documentation kinds you're writing (tutorial/how-to/reference/explanation), keep them separate, and organize the whole docs set around the reader's journey rather than the system's structure.

Diataxis Documentation

Most bad docs blur all four. Separating them is the biggest single improvement.

Map audiences + journeys (newcomer / integrator / operator); structure around what they're doing, not your module tree.

name	diataxis-documentation
description	Apply the Diataxis framework: identify which of the four documentation kinds you're writing (tutorial/how-to/reference/explanation), keep them separate, and organize the whole docs set around the reader's journey rather than the system's structure.

Most bad docs blur all four. Separating them is the biggest single improvement.

Map audiences + journeys (newcomer / integrator / operator); structure around what they're doing, not your module tree.

diataxis-documentation