关于整理笔记的小结
2014-05-09
疑惑
思考：为什么东西都做出来了，整理总结一下，需要这么长的时间？
分析
几个问题：
- 总结写什么？写自己遇到问题以及解决办法的整个过程？还是对遇到的问题进行提炼，之后在较高的角度进行分析/说明？
- 写东西的目标是什么？是为防止自己忘记，加强自己记忆为主？还是为给后来人做一个铺路，提升团队效率？
- 什么时间写总结？整个事情都完成之后就开始写？还是，伴随任务进行，做好记录，等问题解决之后，再进行问题的一个整理和总结？
- 写总结应该安排多长时间？开发2周，对应写总结1周？还是开发1周，对应总结1天？
- 总结文档的维护？多高的频次来维护？每个月读一次之前的总结，并且进行修改？还是保证6个月之内，至少维护一次文档？
个人观点
文档的整理，以个人兴趣为主，不应该进行强制，否则，效果会很不好；原因很简单，文档写出来是一个过程，但后期的维护、调整，才能保证文档的时效性，如果没有主观上的兴趣/积极性，只会把文档弄得越来越糟糕。
只做精品、长期的精品，短期内可以粗糙一些，小步快跑，针对文档写作这件事：快速文档成型、花时间慢慢雕琢。
关于总结，今后的策略：
- 今后，遇到事情，边解决、边记录，思考过程也可以记录下来，以及一些必要的截图、参考来源；
- 参考来源，多选择一手资料：官网\google\stackoverflow；
- 什么时间总结？问题一旦解决，第一时间总结成文档，不要将几个总结堆积在一起。
- 总结内容？就写自己遇到问题、思考、参考来源、解决办法。（要把自己解决问题的思路、途径展现出来，影响读者）。
原文地址：https://ningg.top/how-to-write-summary/