文檔撰寫

• 我不贊同 Diátaxis 架構 2026年8月29日

  原本是寫在技術寫作的相關重點裡面的，不過越寫越長乾脆就把他變成一篇文章了。

  做了越多功課之後越不贊同 Diátaxis 結構。他雖然沒有直接說出四個象限就必須照順序寫，但是他自己的說明、編排和單向迴圈的圖示，實際上已經非常明示該這樣寫了。

• 技術寫作的相關重點 2026年8月28日

  本文整理技術寫作相關知識，還在很草稿的階段，因為我自己的知識也還不足以真正介紹這個主題。

• Technical Writing: Microsoft 2026年8月28日

  這是 Claude 翻譯的 Top 10 tips for Microsoft style and voice，會寫這篇文章是因為 Hugo 文檔實在是太爛了因此才有動機研究「怎麼寫好文檔」。

• Technical Writing: hireawriter.us 2026年8月28日

  這是 Claude 翻譯的 English Grammar Rules for Technical Documents: 20 Dos and Don'ts，會寫這篇文章是因為 Hugo 文檔實在是太爛了因此才有動機研究「怎麼寫好文檔」。

• Technical Writing: draft.dev 2026年8月28日

  這是 Claude 翻譯的 The Draft.dev Technical Blogging Style Guide，會寫這篇文章是因為 Hugo 文檔實在是太爛了因此才有動機研究「怎麼寫好文檔」。

• diataxis documentation 2025年9月5日
  更新

  對 Diátaxis 有更深的理解了，見我不贊同 Diátaxis 架構

  Hugo 文檔的問題眾所皆知，Hacker News 也有討論這個問題，比如說文檔的這張擷圖，你能找到怎麼安裝 Hugo 嗎？