writing-documentation-with-diataxis

SKILL.md

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.

Applique le framework Diataxis pour créer ou améliorer la documentation technique. À utiliser lorsqu'on vous demande de rédiger des didacticiels, des guides pratiques, des documents de référence ou des explications de haute qualité, lors de l'examen de la qualité de la documentation ou lorsque vous décidez du type de documentation à créer. Aide à identifier les types de documentation à l’aide des dimensions action/cognition et acquisition/application. Source : sammcj/agentic-coding.

Voir l'original