Diátaxis 文件四型

Diátaxis · Procida

已對照來源本身 ✓ 個人知識管理 · 文件學私下告訴編輯 ▸

三句講透文件寫不好，多數不是文筆問題，是四種讀者需求被塞進同一份文件。
Diátaxis 用兩條軸拆開：讀者在做還是在想、在學還是在用，推出四型：tutorial、how-to、reference、explanation。
核心主張是四型各有其職，寫法不要互相滲透；框架不規定實作形式，要不要拆成不同檔案是使用者自己的取捨。

↳ 見過反例？

圖 1 · 兩軸推導四型示意：實作對認知（做還是想）× 學習對應用（在學還是在用），落出 tutorial、how-to、reference、explanation 四格，各服務一種讀者需求。放大看圖 ▸

一、發生什麼事

Procida 在 Divio 任職期間（2014 至 2021）發表過這套想法的早期版本，他後來自認其中部分看錯，其後獨立為 diataxis.fr 持續打磨[1]Procida, D. Diátaxis. 兩軸推導、Divio 時期與 2021 年之說明已對照原站核實。（diataxis.fr）。primary 站三頁（主頁、foundations、colophon）核對：四型名稱與詞源逐字對上；早期版本於 Divio 任職期（2014–2021）發表，Procida 後來自認其中部分看錯；「2021」指 Software Sustainability Institute fellowship，非首發年；採用廣度為站方自述，未經第三方驗證。。推導不是任意分類：讀者處境沿兩條軸分化，實作（knowing-how）對認知（knowing-that），學習時對工作時，二乘二落出四型，每型服務一種需求、各有獨立寫作準則。tutorial 是學習中的實作引導，how-to 是工作中的達成步驟，reference 是工作中查資訊，explanation 是學習中求理解。混寫的失敗形態每個人都見過：一份「教學」開頭教操作、中段變參數表、結尾寫設計哲學，每種讀者都要跳讀。

署名要給對：框架沒有單一首發年：早期版本發表於 Divio 時期，「2021」指 Software Sustainability Institute fellowship，勿當「2021 年提出」引用。採用廣度（站方稱數百個文件專案）為自述，未經第三方驗證；引用時保留這個限定[1]Procida, D. Diátaxis. 兩軸推導、Divio 時期與 2021 年之說明已對照原站核實。（diataxis.fr）。primary 站三頁（主頁、foundations、colophon）核對：四型名稱與詞源逐字對上；早期版本於 Divio 任職期（2014–2021）發表，Procida 後來自認其中部分看錯；「2021」指 Software Sustainability Institute fellowship，非首發年；採用廣度為站方自述，未經第三方驗證。。