今天我和一位前思科同事、一家软件创新公司的首席执行官以及他的几位同事聊天。 这期间，一个话题出现了，他很着急，也很无助。 公司开发人员的开发能力是毋庸置疑的，但没有人愿意出品伴随开发工作的注释文档和说明书技术文档。 他们总是拖延。 即使必须做，文件的质量也不高。
这让我很惊讶，因为我在另一家 SaaS 公司看到和听到了类似的现象。 那么是否可以推断这是软件开发公司的普遍现象呢？
造成这种普遍现象的根本原因是什么？ 我们来做一个简单的分析。
首先是软件工程师的价值取向。 从享受看得见的成果的角度来看，很明显，当你开发的功能模块上线时，开发者会有一种成功感和满足感，这会给枯燥的开发过程增添绚丽的色彩，这是人性的自然取向。 文档工作是开发的结束。 相对而言，其效果并不那么明显，开发者无法获得成功的喜悦。
二是公司考核导向。 通常企业都把新功能模块的按时成功上线视为开发工作的重要里程碑，每个人都在为实现这一里程碑目标而努力。 文档工作对于时间和质量没有明确的要求，开发人员自然会偷懒。
第三，就像一个勇敢的战士冲锋陷阵并取得巨大战果一样，他很难理解能够取得胜利的战略战术。 开发商也有类似的情况。 他会写代码、实现功能，但不一定能够清楚地理解外部场景和内部逻辑，更不用说交出高质量的文档了。
第四，当今工科专业的男性学生看重理论胜过写作。 很多人不重视作文写作开发文档软件，对写作有天然的恐惧和抵触情绪。 即使勉强写出来，文章却离题、逻辑不通、细节不恰当，让读者看不清楚。 茶壶煮饺子时，胃里有很多饺子，倒不出来。
图片来自网络
作为软件公司，尤其是开发部门的领导开发文档软件，面对这样普遍的现象，应该采取什么措施来改变呢？
首先是价值观和文化建设。 客户价值最大化的理念必须深入到每一位员工的骨子里。 产品的可用性、易用性、可靠性和用户体验是决定一个软件公司能否生存和发展的关键要素。 。
其次，要有工匠精神，对产品的全生命周期负责。 我们要像玉雕大师一样，不仅精心雕琢出美丽的玉石，还将精美的玉雕与高档的紫檀底座相匹配，使两者相得益彰。
第三，在管理考核方面，应将新功能模块的上线和文件输出捆绑在一起作为里程碑。 负责质量控制的测试部门不仅要测试产品的功能、性能、Bug，还要检查文档质量，严格控制这方面。 关闭。
第四，开发人员在分配开发任务时，必须有意识地了解业务应用场景以及可能给客户带来的价值，这样才能下意识地将自己的工作与客户价值的实现联系起来。
第五，选人用人时，注重选拔文理兼顾、技艺高超、逻辑清晰、表达清晰的人才，寻找能练能说的人。
还有一个总体的、长期的预期。 我们必须想办法消除中小学教育中文理科的短板。
请分享您的看法。
2019 年 2 月 27 日
探访北京唐泽
相关文章
1.
3.
