标签：作好总结
读了不少书，却几乎没怎么做过笔记
。
一方面是由于自己比较“懒”，另一方面是之前没有那么深刻地意识到总结的重要性。
直到有一天……
发现对于新接手的工作无从下手。
遂请教组内前辈，望其赐予总结文档若干，并指导一二。
然前辈手上文档寥寥，且不成体系。曰，不懂即问，熟能生巧。
之后接了个小需求，在前辈“详细”讲解了需求的开发流程之后，我就屁颠屁颠地去开始搞了。
鄙人：前辈帮我看下，这儿怎么报了个模型参数错误，这个参数表示啥意思？
前辈：这个参数表示……balabala……
鄙人：哦，原来是这个意思啊，我看还有其他参数我也一知半解的，有没有相关参数的说明文档？
前辈：我这儿有个自己总结的一小部分，不过不全，你以后补全下。
鄙人：哦，好吧……
PS：前辈好歹总结了一小部分……
鄙人：前辈，模型文件我改完了，帮我看下为啥编译失败了，看不懂这个提示信息啊。
前辈：我们使用的这个框架在模型文件修改完成后，需要用工具基于模型文件生成一些中间文件，之后才能编译模型文件，最后再编译代码……
鄙人：有相关文档说明吗？
前辈：暂时没有，你之后总结一个吧。
鄙人：……
鄙人：前辈，我开发完了，怎么验证呢？
前辈：XXX之前总结过一篇文档，我待会儿发给你，有问题就找XXX。
鄙人：好的。
按文档操作，遇到不懂的地方之后……
鄙人：XXX，你好，我按照你写的文档进行需求的自验证，发现……
XXX：哦，你说的这个情况我也不知道怎么回事，主要是我很久没做相关的事儿了，文档中写的内容我现在也记不怎么清了，忘了当时具体怎么操作的了。你可以试试其他的方法……
鄙人：……
终于，自验证基本 OK 了……
鄙人：前辈，需求开发验证完了，可以上库了吧。
前辈：可以了。
鄙人：我已经提了 MergeRequest 了。
前辈：好的，待会儿我给你批了。
前辈批准 MergeRequest 之后……
前辈：pclint跑过了没？用例都跑过了没？
鄙人：CI 不是都集成了吗。我看看，pclint 过了，不过用例好像挂了几个……
前辈：尽快把用例都调试好。
鄙人：好的……
前辈：哦，对了，忘了跟你说，你这个需求还有些其他工作需要做，balabala……，尽快补上哈。
鄙人：哦，好的。除了这些还有其他的吗？
前辈：嗯，应该没有了。
PS：其实前辈是组内大牛，经常有人向他请教问题。另外他总结的文档其实挺多的，不过对于我这种新手来说缺少了点工作流程相关的指导文档（其实前辈也有总结相关的文档，不过有点显旧，和现有流程有些不符）。
直到有一天……
同事经常向我询问 git 相关问题。
同事甲：XXX，过来帮我看下，我切不了分支了。
鄙人： 当前分支有没有未提交的修改？
同事甲：好像有。
鄙人：不需要保存的修改就 revert 掉，需要保存的就先 stash 或 commit，之后你再试试。
过了一会儿之后……
同事甲：可以了，哈哈……
同事乙：XXX，我在 master 分支上改东西了，还很多，我没权限往 master 分支 push 的权限，怎么办。
鄙人：没事，先 commit 吧，再基于此拉个分支就行了，之后用新分支上库，回退掉 master 分支的修改就行了。
同事乙：这样子也行？
鄙人：放心吧，下次记得先拉分支啊。
同事丙：XXX，我没用过 git ，他们让我找你了解下基于 git 的开发流程，跟我说说呗。
鄙人：balabala……记住了没？
同事丙：（一脸茫然）好复杂，有文档没？
鄙人：暂时没有……
…………
…………
终于有一天……
鄙人再也忍受不了经常被同事的询问而打断自己手上的工作。
遂作一篇总结，广而告之，于是问者寥寥。
本文出自 “换个姿势看知识” 博客，转载请与作者联系！
标签：作好总结
原文地址：http://keepasking.blog.51cto.com/6511422/1764328
