读新人要做的五件事

前面四件事是了解技术架构、了解开发流程、补强基础知识、从微小的改善入手(比如关掉几个 issue)。这些都是常识,但是第五件事,很多新人都没意识到,你应该要去做,而且完全有能力做,那就是 你要为团队写文档

国内的现状是,项目文档很少,或者索性没有,因为大家的精力都被开发占据了,没有余力写文档。新人了解技术细节的方式,就是别人跟你口头说一下,然后自己去看代码。你正好趁着熟悉代码的过程,补写一些文档。不需要写得很好,只要忠实记录代码的线索、架构的细节,能为以后的人(包括你自己)节省一点时间就可以了。

我自己的体会是,写文档对一个人的锻炼是很大的。(1)可以熟悉项目;(2)可以提高表达能力;(3)可以提高技术能力,因为只有理解了代码才能表达出来,文档越清晰,就代表思路越清晰;(4)可以提高个人影响力,文档写得越好,看的人就越多。久而久之,你就会成为项目的代言人,别人有问题就会来找你。

总之,新人要重视写文档,主动为整个团队写文档,对个人成长有帮助,对团队也会有帮助。不停地写,大量地写,现在就开始写。长期中,你会意识到这给自己带来的巨大价值。

科技爱好者周刊:第 87 期(20191220) · 语雀

So You’re A New Grad Software Engineer | Pulchra Technica

原文地址:https://www.cnblogs.com/lingr7/p/12088065.html