Kely
程序员鼓励师
获得徽章 6
- 新人加入一个开发团队时，要干五件事：
1. 了解技术架构；
2. 了解开发流程；
3. 补强基础知识
4. 从微小的改善入手（比如关掉几个 issue）
5. 为团队写文档
国内的现状是，项目文档很少，或者索性没有，因为大家的精力都被开发占据了，没有余力写文档。新人了解技术细节的方式，就是别人跟你口头说一下，然后自己去看代码。
你正好趁着熟悉代码的过程，补写一些文档。不需要写得很好，只要忠实记录代码的线索、架构的细节，能为以后的人（包括你自己）节省一点时间就可以了。
写文档对一个人的锻炼是很大的
1. 可以熟悉项目；
2. 可以提高表达能力；
3. 可以提高技术能力，因为只有理解了代码才能表达出来，文档越清晰，就代表思路越清晰；
4. 可以提高个人影响力，文档写得越好，看的人就越多。久而久之，你就会成为项目的代言人，别人有问题就会来找你。
总之，新人要重视写文档，主动为整个团队写文档，对个人成长有帮助，对团队也会有帮助。不停地写，大量地写，现在就开始写。长期中，你会意识到这给自己带来的巨大价值。
摘抄自《科技爱好者周刊：第 87 期》 —— 阮一峰展开612