大道至简阅读笔记04
本周我阅读了《大道至简》的第4张——流于形式的沟通,读后反思与感慨也是颇多的,下面与大家分享一下。
为不存在的角色留下沟通的渠道,这一节对自己来说体会是最多的。之前我们或其他自己所知道的团队中都存在这样一个问题:维护旧项目比做新项目更难;或是很多时候当项目负责人员离开后,项目就中断和中止。 许多人应该深有同感。
本书中对此情况进行了说明,把这一切的原因归咎于“没有history”。历史记录(History)与注释(Comment)不是一回事。代码中的注释是为阅读代码而留备的,而History是为整个项目而记录的。项目的History作为跟这种“不存在的角色”沟通的一种方式,它的丰富和准确为项目的后继开发、维护提供了可能。本书中对记录History的方式进行了详细的说明:一些参考的记录内容有:
1. 需求阶段:与谁联系,联系方式、过程、结果以及由此引发的需求或变更;
2. 设计阶段:如何进行设计、最初的构架、各个阶段的框架变化、因需求变更导致项目结构上的变化(有助于了解构架的可扩充性);
3. 开发阶段:每一种技术选型的过程、每一种开发技巧的细节和相关文档、摘引的每一段代码、算法、开发包、组件库的出处和评测;程序单元的测试框架; 每一个设计和构架变更所导致的影响;
4. 测试阶段:还记得测试用例和测试报告吗?那是最好的history之一。
! 另一件最重要的事,是记得在每一笔记录后写下时间和你的名字。你的每一笔记录都是打算留给一些根本不了解这个项目的人看的,之所以要记下你的名字, 是便于那些人能够再找到你并溯源到问题的源头。
在我们今后的团队开发过程以及之后走上工作岗位后,记录项目的History,我觉得很重要,是造福后人,名垂青史的举动(说的有点言重了,哈哈,不过自己主要是想告诉大家它的重要性!)。