week15

本周的心得是写文档。

同事突然因病请假，得找一个人接替。测试工作的简单之处在于，上手非常快，软件都是做出来给人用的，没理由研读三天文档才能开始。而更重要的理由是，由于敏捷开发，所有人都懒得写文档，东一块，西一块的，压根儿没有结构清楚，更新及时的文档。当然，也不是完全没有文档的，公司负责CMMI3评审的经理就不止一次的对我说，我们部门的文档管理已经算很好了（因为我的部门比较小，因此CMMI每年一小评，三年一大评）。如果组织上要求不明确，则想写就写，自由发挥的空间比较大，文档好或者烂，多或者寡，完全依赖于写作者的水平，以及阅读者的期待。我花了一天的时间整理好文档，分享给需要接手工作的同事。有几点心得：

第一，文档存放的位置最好统一。我们的文档显得复杂，是因为有文档分散在不同的地方，jira，git，google doc，邮件，公司的平台，测试管理工具，等等，还有各种环境数据库，简直是要疯。对于新接触项目的人，分分钟要疯。

第二，文档的内容应尽量准确。有的文档已经过时了，有的没有反映实际情况。比如对于大的项目，设计文档写得都挺漂亮的，但实际实现有调整了，真是没处找。

第三，文档需要有人经常整理。就像房间一样，虽然搜索功能已经做的比较方便了，但是如果有一个主线的话，阅读和检索就会更加方便。

week15

我已经在这个组织很多年了，大脑里自有一套知识系统。有新人入职的话，总会就文档问题有所困惑，解释以后新同事就慢慢适应了。细想起来，我们的文档还是有很多值得改进的地方，以上三条说起来容易，项目一多，事情一忙，既没有规范也没有人专门负责，时间长了，就像一个没有维护的花园，也很丰富，缺了一点美感。

我最近在给娃写一份《武功秘籍》，起因是他和同学为小事打了架被老师教育，难过伤心不服气。为了显示秘籍的珍贵，我故意收了他50元。现在已经写到第五章，分别是：

1）和同学闹矛盾怎么办

2）IQ，EQ和AQ

3）好好说话

4）时间都去哪儿了

5）学会学习

因为付了钱，娃还挺当回事的，我也觉得挺满意。