Working Software over Comprehensive Documentation
一场精彩的CMMI论战 Herequoted from o6z's post:
文档最忌讳繁琐无比，事无巨细的都要说明，如果是这样我直接去看代码好了。实际上多数人都默认文档的抽象程度比代码级别高，看文档比看代码省事。但是如果你的文档过于细节化，那么你的代码很难做到同步于文档。这将是一个巨大的威胁。很多人抱怨要看一堆没文档的代码，但是他们很少真的看到过合适的文档。实际上文档的作用应该是让阅读者快速找的代码的位置，而不是用文字说明代码的作用，那些应该是单元测试的事情。
人员的流动带来的最大问题，实际是知识的流失。文档可以固定下一部分的知识，但是如果文档的抽象层次不够，这些知识并不能很容易的被掌握，那么这些就是无用功。
vanillaing said:
06/03/2006, at 08:09 [ 回复 ]
为啥你们都有广告，就我老是公益的 :(
blueoxygen said:
06/03/2006, at 10:01 [ 回复 ]
你比我们善良.