大道至简阅读笔记04

Posted 2020-07-03 勋爵

      本周我阅读了《大道至简》的第4张——流于形式的沟通，读后反思与感慨也是颇多的，下面与大家分享一下。

     为不存在的角色留下沟通的渠道，这一节对自己来说体会是最多的。之前我们或其他自己所知道的团队中都存在这样一个问题：维护旧项目比做新项目更难；或是很多时候当项目负责人员离开后，项目就中断和中止。 许多人应该深有同感。
     本书中对此情况进行了说明，把这一切的原因归咎于“没有history”。历史记录(History)与注释(Comment)不是一回事。代码中的注释是为阅读代码而留备的，而History是为整个项目而记录的。项目的History作为跟这种“不存在的角色”沟通的一种方式，它的丰富和准确为项目的后继开发、维护提供了可能。本书中对记录History的方式进行了详细的说明：一些参考的记录内容有：
            1. 需求阶段：与谁联系，联系方式、过程、结果以及由此引发的需求或变更；
            2. 设计阶段：如何进行设计、最初的构架、各个阶段的框架变化、因需求变更导致项目结构上的变化(有助于了解构架的可扩充性)；
            3. 开发阶段：每一种技术选型的过程、每一种开发技巧的细节和相关文档、摘引的每一段代码、算法、开发包、组件库的出处和评测；程序单元的测试框架；                  每一个设计和构架变更所导致的影响；
            4. 测试阶段：还记得测试用例和测试报告吗？那是最好的history之一。

           ！ 另一件最重要的事，是记得在每一笔记录后写下时间和你的名字。你的每一笔记录都是打算留给一些根本不了解这个项目的人看的，之所以要记下你的名字，               是便于那些人能够再找到你并溯源到问题的源头。

     在我们今后的团队开发过程以及之后走上工作岗位后，记录项目的History，我觉得很重要，是造福后人，名垂青史的举动（说的有点言重了，哈哈，不过自己主要是想告诉大家它的重要性！）。