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.

Diataxis 프레임워크를 적용하여 기술 문서를 작성하거나 개선합니다. 고품질 튜토리얼, 방법 가이드, 참조 문서 또는 설명을 작성하라는 요청을 받을 때, 문서 품질을 검토할 때 또는 작성할 문서 유형을 결정할 때 사용합니다. 작업/인지 및 획득/적용 차원을 사용하여 문서 유형을 식별하는 데 도움이 됩니다. 출처: sammcj/agentic-coding.

원본 보기