获得徽章 6
赞了这篇沸点
新人加入一个开发团队时,要干五件事:
1. 了解技术架构;
2. 了解开发流程;
3. 补强基础知识
4. 从微小的改善入手(比如关掉几个 issue)
5. 为团队写文档


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


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

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

摘抄自《科技爱好者周刊:第 87 期》 —— 阮一峰
展开
6
赞了这篇沸点
你要做什么事情,就大摇大摆往前走,没有问题就不要幻想问题,出现问题咱就解决问题
评论
关注了标签 Canvas Canvas
关注了标签 源码 源码
关注了标签 Apple Apple
关注了标签 产品经理 产品经理
关注了标签 TypeScript TypeScript
关注了标签 创业 创业
关注了标签 全栈 全栈
关注了标签 ECMAScript 6 ECMAScript 6
关注了标签 产品 产品
关注了标签 人工智能 人工智能
关注了标签 开源 开源
关注了标签 Git Git
关注了标签 Python Python
关注了标签 React.js React.js
关注了标签 设计模式 设计模式
关注了标签 Node.js Node.js
下一页
个人成就
文章被点赞 1
文章被阅读 1,053
掘力值 47
收藏集
0
关注标签
23
加入于