タグ: #information-architecture
GPU・LLM・MLOps・Kubernetes、そしてマインドセット · 1 件
Diátaxisを四つのフォルダと誤解する理由 — ひとつの文書に二つのモードを混ぜるとなぜ崩れるのか
Diátaxisは文書をチュートリアル・ハウツー・リファレンス・説明の四種類に分けます。ところがチームのほとんどはフォルダを四つ作ったところで適用を終え、肝心の問題はそのまま残ります。本当の失敗は分類ではなく、ひとつの文書のなかで四つのモードを混ぜるときに起きるからです。混ざるとなぜ崩れるのかを、フレームワークが根拠にする二つの軸から辿り直し、段落単位で判定する羅針盤と、今週すぐ回せる作業ループまで整理しました。
2026-08-09 · 16 分で読めます #documentation#diataxis#technical-writing#developer-experience#information-architecture