读了不少书,却几乎没怎么做过笔记j_0009.gif

一方面是由于自己比较“懒”,另一方面是之前没有那么深刻地意识到总结的重要性。




直到有一天……

发现对于新接手的工作无从下手。


遂请教组内前辈,望其赐予总结文档若干,并指导一二。

然前辈手上文档寥寥,且不成体系。曰,不懂即问,熟能生巧。


之后接了个小需求,在前辈“详细”讲解了需求的开发流程之后,我就屁颠屁颠地去开始搞了。


鄙人:前辈帮我看下,这儿怎么报了个模型参数错误,这个参数表示啥意思?

前辈:这个参数表示……Blabla……

鄙人:哦,原来是这个意思啊,我看还有其他参数我也一知半解的,有没有相关参数的说明文档?

前辈:我这儿有个自己总结的一小部分,不过不全,你以后补全下。

鄙人:哦,好吧……

PS:前辈好歹总结了一小部分……j_0004.gif


鄙人:前辈,模型文件我改完了,帮我看下为啥编译失败了,看不懂这个提示信息啊。

前辈:我们使用的这个框架在模型文件修改完成后,需要用工具基于模型文件生成一些中间文件,之后才能编译模型文件,最后再编译代码……

鄙人:有相关文档说明吗?

前辈:暂时没有,你之后总结一个吧。

鄙人:……


鄙人:前辈,我开发完了,怎么验证呢?

前辈:XXX之前总结过一篇文档,我待会儿发给你,有问题就找XXX。

鄙人:好的。

按文档操作,遇到不懂的地方之后……

鄙人:XXX,你好,我按照你写的文档进行需求的自验证,发现……

XXX:哦,你说的这个情况我也不知道怎么回事,主要是我很久没做相关的事儿了,文档中写的内容我现在也记不怎么清了,忘了当时具体怎么操作的了。你可以试试其他的方法……

鄙人:……


终于,自验证基本 OK 了……

鄙人:前辈,需求开发验证完了,可以上库了吧。

前辈:可以啊。

鄙人:我已经提了 MergeRequest 了。

前辈:好的,待会儿我给你批了。

前辈批准 MergeRequest 之后……

前辈:pclint跑过了没?用例都跑过了没?

鄙人:CI 不是都集成了吗。稍等,我确认下,pclint 过了,不过用例好像挂了几个……

前辈:尽快把用例都调试好。

鄙人:好的……

前辈:哦,对了,忘了跟你说,你这个需求还有些其他工作需要做,Blabla……,尽快补上哈。

鄙人:哦,好的。除了这些还有其他的吗?

前辈:嗯,应该没有了。


PS:其实前辈是组内大牛,经常有人向他请教问题。另外他总结的文档其实挺多的,不过对于我这种新手来说缺少了点工作流程相关的指导文档(其实前辈也有总结相关的文档,不过有点显旧,和现有流程有些不符)。




直到有一天……

同事经常向我询问 git 相关问题。


同事甲:XXX,过来帮我看下,我切不了分支了。

鄙人: 当前分支有没有未提交的修改?

同事甲:好像有。

鄙人:不需要保存的修改就 revert 掉,需要保存的就先 stash 或 commit,之后你再试试。

过了一会儿之后……

同事甲:可以了,哈哈……


同事乙:XXX,我在 master 分支上改东西了,还很多,我没权限往 master 分支 push,怎么办。

鄙人:没事,先 commit 吧,再基于此拉个分支就行了,之后用新分支上库,回退掉 master 分支的修改就行了。

同事乙:这样子也行?

鄙人:放心吧,下次记得先拉分支啊。


同事丙:XXX,我没用过 git ,他们让我找你了解下基于 git 的开发流程,跟我说说呗。

鄙人:Blabla……记住了没?

同事丙:(一脸茫然)没记全,有文档没?

鄙人:暂时没有……


…………

…………


终于有一天……

鄙人再也无法忍受手上的工作经常由于同事的询问而被打断了。

遂作一篇总结,广而告之,于是问者寥寥。