人月神话阅读笔记03

Posted 2020-07-28 卿语

   阅读了《人月神话》第10章 提纲掣领，里面提到的关于软件相关的开发文档的问题，使我受益颇深。以前每每写程序时，老师总会要求我们写一些需求分析，软件流程图，还有各种各样的日志文档，心里总是觉得烦不胜烦。明明程序已经写好了，文档写不写又有什么关系呢？这不是在浪费时间嘛。但是后来在写四则运算的编程题时，我就遇到了一些麻烦。刚开始我自己写又进行“翻新”的时候，我总是忘了自己之前是怎么想的，思路是怎么样的，很多时候不得不花上许多时间去重新阅读上次的代码，或者直接推翻重写。后来进行二人开发时，发现没有文档，交流起来其实挺费劲的，我不知道你是怎么写的，写到什么程度，而我要改动到哪里。后来读了第10章，我就明白了我们缺乏规范的文档书写交流，规范的文档真的很有用。之前认为没有用是因为那些作业就是写了一次就过的东西，不用翻新整改，也不用和别人进行交流。但是到了二人开发的时候就不一样了，阅读别人留下的文档就能明白他的思路和做法，方便交流和沟通。尤其是程序流程图一定要画的够详细，不能太简略，力求不同的人看到这样的程序流程图写出的程序相差无几。书里面提到，文档能够帮助人们记下很多的决策，方便以后查询，也能够作为与其他人沟通的渠道。的确，规范的文档在后来我们的团队开发中起了很大的帮助。