Diátaxis：技術文書作成の体系的フレームワーク
Judul asli: Diátaxis
Mengapa Ini Penting
数百プロジェクトで採用実績があり、技術文書品質向上の標準的手法として業界に普及している。
Diátaxisは技術文書を「チュートリアル」「ハウツーガイド」「リファレンス」「説明」の4種類に分類し、ユーザーニーズに基づいた文書設計を提案するフレームワークです。
Diátaxisは、Daniele Procidaが提唱する技術文書作成のための体系的なアプローチです。古代ギリシャ語の「dia（横断）」と「taxis（配置）」に由来し、文書のコンテンツ（何を書くか）、スタイル（どう書くか）、アーキテクチャ（どう整理するか）に関する問題を解決することを目的としています。フレームワークはユーザーの4つのニーズを特定し、それぞれに対応する形式としてチュートリアル、ハウツーガイド、技術リファレンス、説明を定義します。実績としてVonage、Gatsby、Cloudflareなど数百のプロジェクトで採用されており、Cloudflareの開発者向けドキュメント再設計ではアーキテクチャの指針として活用されました。軽量で導入しやすく、実装上の制約を課さない点が特徴です。