今儿个就跟大家伙儿聊聊“文长”这事儿。咱这儿说的“文长”，可不是说写文章啰嗦，而是有时候，你真得把一件事儿从头到尾，仔仔细细给它说明白了，那长度自然就上去了。我就有过这么一回实践，现在回想起来，还挺有意思的。
为啥要写长的？
起初，我也是觉得，现在这快节奏，谁有耐心看长篇大论？短小精悍才是王道。可有一次，我接手了一个项目，也不是啥惊天动地的大项目，但里头弯弯绕绕特别多，历史遗留问题也不少。关键是，之前负责的人，交接的时候说得不清不楚，文档也少得可怜。 我当时就头大，抓瞎了好几天。
后来好不容易把这摊子事儿给理顺了，我就琢磨着，不行，我得把这整个过程，遇到的坑，怎么解决的，前因后果都给它记下来。一来，是给我自己做个备忘，怕以后忘了；二来，万一以后再有别人接手，或者遇到类似的问题，也能有个参考，别再像我一样抓瞎了不是？目标就一个：全面、细致，不怕长！
我是咋开始的？
说干就干。我先没急着动笔，而是把所有相关的资料，比如零散的笔记、邮件沟通、聊天记录，甚至是当时为了解决问题随手画的草图，都给它翻了出来，堆了一桌子。看着这堆东西，我又有点犯怵，这得写到猴年马月去？
冷静了一下，我决定先搭个架子。我就想，如果我要给一个完全不懂这事儿的人讲明白，我得从哪儿说起？
- 第一步，肯定得是背景介绍，这事儿是咋来的。
- 第二步，碰到了哪些主要的问题，具体表现是
- 第三步，我尝试了哪些解决方法，哪些行，哪些不行，为
- 第四步，最终是怎么解决的，关键点在哪儿。
- 第五步，总结一下经验教训，以后要注意
这么一梳理，思路就清晰多了。感觉就像盖房子，先把承重墙和柱子立起来，心里就有底了。
中间咋捣鼓的？
有了大纲，我就开始往里头填肉了。这个过程挺枯燥的，就是回忆，然后敲键盘。我尽量用大白话，把当时咋想的，咋做的，都原原本本地写出来。 有些细节，比如某个参数为啥那么设置，某个步骤为啥不能省略，我都掰开了揉碎了写。中间好几次我都想放弃，觉得太琐碎了，写这么多有啥用？但一想到之前抓瞎的痛苦，就又咬咬牙坚持下去了。
写着写着，我还发现一个好处。就是有些当时觉得理所当然的操作，在复盘写下来的时候，会突然冒出新的想法：“当时要是那么做，会不会更”或者“，原来这个问题的根源是那个！” 这感觉，就像把一团乱麻慢慢解开，越解越顺。
我还特别注意，遇到一些关键的节点或者重要的决策点，就加粗标记一下，或者用个小标题隔开，这样以后查阅起来也方便。图片、流程图啥的，只要能帮助理解，我也都给它配上。虽然麻烦，但想着以后能省事儿，也就值了。
弄成了啥样？
前前后后折腾了差不多一个星期，每天下班抽点时间写，周末又加了加班，总算是把这篇“文长”给搞出来了。Word文档一看，好家伙，密密麻麻几十页。我自己通读了一遍，虽然长，但是逻辑清晰，细节也都有了，基本上把我想表达的都说明白了。
后来这篇东西还真派上用场了。有一次团队来了新人，正好要接触这块儿业务，我就把这文档甩给他。他看完以后，上手快多了，省了我不少口舌。再后来我自己偶尔遇到类似的问题，也会翻出来看看，每次都有新的启发。
我觉得“文长”并不可怕。关键在于你为啥要写长，以及怎么把它写得有价值。只要是能把事儿说透，能帮到自己或者别人，那这个“长”就是值得的。 这就是我的一次实践经历，希望能给大家伙儿一点启发。
还没有评论，来说两句吧...