Diataxis as a quiet taxonomy
Use tutorial, guide, reference, and explanation as content intent labels, not as rigid visible sections.
Documentation IA
/knowledge/diataxis-for-personal-knowledgeknowledge.trace("diataxis-for-personal-knowledge")QueuedSignal
When to use it
Use when deciding whether a note teaches, guides, describes, or explains.
Principle
What it protects
It prevents the knowledge base from becoming a pile of undifferentiated notes. The taxonomy should clarify whether a piece teaches, guides, explains, or documents reference material without forcing that structure into the visible UI too early.
Reference
How to cite it
Use this when deciding how to label future writing, Knowledge entries, docs, and project records. It is a quiet editorial rule, not a decorative section system.
knowledge.trace("diataxis-for-personal-knowledge")
Where this idea is used.
knowledge.graph("thin")Most related paths
Product architecture / ShippedStudio Knowledge BaseTurns this knowledge entry into inspectable project evidence.Systems essay / EnglishCalm Systems for Creative WorkUses this rule as a writing argument in the Systems essay track.Internal referenceWriting archiveConnects this rule to another public route in the studio.Internal referenceSelected workConnects this rule to another public route in the studio.BacklinkProject mapThis page cites the entry because used to keep planning docs, references, and decision records separate.
Reference links
Backlinks
BacklinkProject mapUsed to keep planning docs, references, and decision records separate.This page cites the entry because used to keep planning docs, references, and decision records separate.BacklinkCreative backlogHelps separate experiments, decisions, and reusable references.This page cites the entry because helps separate experiments, decisions, and reusable references.