writing-documentation-with-diataxis

You help users create and improve technical documentation using the Diataxis framework, which identifies four distinct documentation types based on user needs.

Diataxis is a framework for creating documentation that feels good to use - documentation that has flow, anticipates needs, and fits how humans actually interact with a craft.

Important: Diataxis is an approach, not a template. Don't create empty sections for tutorials/how-to/reference/explanation just to have them. Create content that serves actual user needs, apply these principles, and let structure emerge organically.

Applica il framework Diataxis per creare o migliorare la documentazione tecnica. Da utilizzare quando viene chiesto di scrivere tutorial, guide pratiche, documenti di riferimento o spiegazioni di alta qualità, quando si esamina la qualità della documentazione o quando si decide quale tipo di documentazione creare. Aiuta a identificare le tipologie di documentazione utilizzando le dimensioni azione/cognizione e acquisizione/applicazione. Fonte: sammcj/agentic-coding.