Diataxis

• Diátaxis

  • A framework by Person/Daniele Procida that sorts documentation by what the reader needs, rather than by subject. Its four types are distinct in purpose and should not be blended on one page.

  • The compass

    • Pick the type by the need, not by what is easiest to write.

    • Content…	serves the reader’s…	Type
      informs action	application of skill	Diataxis/How To
      guides learning	acquisition of skill	Diataxis/Tutorial
      informs cognition	theoretical knowledge	Diataxis/Reference
      explains why	understanding	Diataxis/Explanation

  • The four types in this garden

    • Logseq/Entity/Diataxis and its four child entities say how a page of each type is named, tagged and shaped here.