又一个“理想和现实”
可以肯定的是,“代码即文档”一定是一种极其理想的状态。
当我们假定前提为:
`Code is服务器托管网 doc` > `Code + comments` ≈ `Code + docs` > `Code`
我们可以发现,真正的“代码即文档”的践行,是对于编程能力(项目结构、命名及语义风格、设计模式、合作严格审阅、易读性、高效性、简洁性)有着非常高的要求和挑战的,而往往极其难以有人(服务器托管网团队)能真正的做到以上这些的。
为什么我们经常接手的都是无文档无注释的 shit mountain code 项目呢?首先绝大多数程序员连注释都懒得写(例如函数签名注释都懒得写),你更别要求他能给你留下文档了。而更为重要的一点可能则在于:你的编程能力越强,代码即文档践行的越优秀,在现实高压社会环境下,你被新鲜出炉的年轻人代替的概率也会极大提高的(笑)。
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net