文檔撰寫
- 我不完全贊同 Diátaxis 架構
Diátaxis 最近受到很大的推崇,尤其是被開源專案大量參考,但是隨著功課做了越來越多就越不贊同 Diátaxis 架構,包含順序問題和座標軸問題。
- 技術寫作的相關重點
本文整理技術寫作相關知識,還在很草稿的階段,因為我自己的知識也還不足以真正介紹這個主題。
- Technical Writing: Microsoft
這是 Claude 翻譯的 Top 10 tips for Microsoft style and voice。
以下開始翻譯。
我們的現代設計以簡潔俐落為核心。愈短愈好。若想進一步了解,請參閱〈品牌語氣〉。
- Technical Writing: hireawriter.us
這是 Claude 翻譯的 English Grammar Rules for Technical Documents: 20 Dos and Don'ts。
以下開始翻譯。
- Technical Writing: draft.dev
- Diátaxis Documentation
更新
對 Diátaxis 有更深的理解了,見我不贊同 Diátaxis 架構
Hugo 文檔的問題眾所皆知,Hacker News 也有討論這個問題,比如說文檔的這張擷圖,你能找到怎麼安裝 Hugo 嗎?