テクニカルドキュメントの構造化フレームワーク Diátaxis とは - A Memorandum

Diátaxisとは Tutorials How-to guides Reference Explanation Diátaxisとは Diátaxisとはテクニカルドキュメントの構造化フレームワークです。 ユーザーのニーズの体系的な説明と分析に基づいて文書構造を規定するスキームを提供し、多くのソフトウェアのテクニカルドキュメントの体系として採用されています。 Diátaxis という名前は、古代ギリシャ語の dia (横切る)と、taxis(整理・配置) に由来するそうです。 diataxis.fr ドキュメンテーションを 2 つの知識軸 (理論/実践、および習得/応用) に分割して整理 TutorialsとHow-to guidesの両方で、実践的な手順を説明 How-to guidesとReferenceは知識の応用に関係 Reference と Explanation に理論的知識