自一年多没做技术以来,遇到一些技术同事离职或者参与平台的架构技术评审,每次都感觉困难,文档是其中一个重要原因,要么是随意写一份交接文档完事,要么就是简单画几副逻辑图来讲解评审,更多的是靠口诉。要说我们团队的这些技术人员个顶个也都算公司中的“高手”,但是我却觉得他们还欠缺一个真正的高手所需要的“一定要让别人清晰的、简单的理解你做的,所说的”。另外我们是如何了解历史的,我想就是因为很多人写下了历史,我们的程序不就是一部历史吗?


当然这篇文章的标题一写出来,估计有很多程序员朋友就要准备喷我了,说“我们高手都是用代码说话”,说“你看王二就是巴结领导写得一手漂亮文档就顺利升迁,技术和shi一样”,说“教条化外包管理才重视文档,俺们崇尚敏捷、极限的开发不重视文档”......我记得咱程序员这个群体有很多标签“木讷、不善言谈、甚至生活邋遢......”,但是从来没有“不善于写”这点,正是由于”善于写“程序员们才有了”不善言谈”的补充,才有了“闷骚”这个标签。


我觉得一份好的技术文档应该.....光说不练大家肯定鄙视我,见两年多前我写的两份技术文档吧。好不好另说,至少态度

wKiom1bj-i-AQnXNAA_FScyrVJA256.jpg

wKioL1bj_ADA-RDLAAouG8auYE0529.jpg

wKiom1bj-4qyArsOAAj3y-7NalE404.jpg

wKioL1bj_CTyZ_84AAovRHvBHWk792.jpg

wKioL1bkAWCx9kuvAA7sxkzzvA0439.jpg

wKiom1bkAO3TFeTUAAqGQDUfyT8038.jpg

wKioL1bkAYuxEh5bAAg_r0YMuCU269.jpg