可以肯定的是，“代码即文档”一定是一种极其理想的状态。
当我们假定前提为：
1`Code is doc` > `Code + comments` ≈ `Code + docs` > `Code`
我们可以发现，真正的“代码即文档”的践行，是对于编程能力（项目结构、命名及语义风格、设计模式、合作严格审阅、易读性、高效性、简洁性）有着非常高的要求和挑战的，而往往极其难以有人（团队）能真正的做到以上这些的。
为什么我们经常接手的都是无文档无注释的 shit mountain code 项目呢？首先绝大多数程序员连注释都懒得写（例如函数签名注释都懒得写），你更别要求他能给你留下文档了。而更为重要的一点可能则在于：你的编程能力越强，代码即文档践行的越优秀，在现实高压社会环境下，你被新鲜出炉的年轻人代替的概率也会极大提高的（笑）。
版权声明：本文遵循 CC BY-SA 4.0 版权协议，转载请附上原文出处链接和本声明。
Copyright statement: This article follows the CC BY-SA 4.0 copyright agreement. For reprinting, please attach the original source link and this statement.