2026年7月20日 我把測試、程式碼和散文都放在一個 Markdown 檔案裡，再也不用往文件裡複製程式碼了 Literate programming 將 Markdown 檔案作為單一事實來源，使文件、測試和實作保持同步。以下是如何用三十行 Python 實現它。 literate-programmingdocumentationtestingsingle-source-of-truth
2026年7月19日 你的 Claude 對話已經是文件了。只是它會在 12 小時後消失。 LLM 對話包含意圖、被拒絕的替代方案以及可執行的程式碼。這正是文件應該包含的內容。以下是將 ephemeral chat 轉換為持久、可搜尋的文件，同時不遺失敘事的方法。 literate-programmingllmdocumentationai-engineering
2026年7月17日 Donald Knuth希望程式讀起來像文學作品。編譯器另有打算。 Literate programming承諾程式碼應該首先為人類編寫，其次才是為機器。四十年後，幾乎沒有人這樣寫。以下是軟體文件化中最優雅的理念為何未能改變我們工作方式的原因。 literate-programmingknuthsoftware-historydocumentation
2026年6月5日 你的架構圖早已是謊言 架構文件從你存檔的那一刻起就開始腐敗。以下說明如何透過程式碼產生的圖表、ADR 與自動化架構測試，讓文件保持誠實。 deep-divesarchitecturedocumentationliving-docs
