一场精彩的CMMI论战 Here
          quoted from o6z's post:
          文档最忌讳繁琐无比,事无巨细的都要说明,如果是这样我直接去看代码好了。实际上多数人都默认文档的抽象程度比代码级别高,看文档比看代码省事。但是如果你的文档过于细节化,那么你的代码很难做到同步于文档。这将是一个巨大的威胁。很多人抱怨要看一堆没文档的代码,但是他们很少真的看到过合适的文档。实际上文档的作用应该是让阅读者快速找的代码的位置,而不是用文字说明代码的作用,那些应该是单元测试的事情。
          人员的流动带来的最大问题,实际是知识的流失。文档可以固定下一部分的知识,但是如果文档的抽象层次不够,这些知识并不能很容易的被掌握,那么这些就是无用功。



          文章來源:http://blueoxygen.dflying.net/3/archive/45_working_software_over_comprehensive_documentation.html

          只有注冊用戶登錄后才能發表評論。


          網站導航:
           

          posts - 29, comments - 3, trackbacks - 0, articles - 0

          Copyright © BlueO2

          主站蜘蛛池模板: 湖州市| 杭州市| 江津市| 阿克陶县| 吴旗县| 当阳市| 仙游县| 蓝田县| 乌拉特前旗| 东乡族自治县| 逊克县| 晋江市| 文昌市| 揭西县| 郑州市| 托克托县| 汪清县| 锡林浩特市| 涟水县| 治多县| 河曲县| 曲靖市| 滕州市| 定边县| 分宜县| 山东省| 固镇县| 合江县| 辽阳市| 嘉鱼县| 视频| 西充县| 临潭县| 肇州县| 怀集县| 赫章县| 泽普县| 铁力市| 牡丹江市| 临海市| 张北县|