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
