思科wlc产品文档_为什么软件开发的文档工作没人愿做？

今天与一位思科前同事、一家软件创新企业CEO聊天，还有几个他的同事一起。期间谈到一个话题，他很着急，也很无奈。公司的开发人员的开发能力毋庸置疑，但是伴随着开发工作的注释文档、使用说明技术文档却没人愿意做，总是拖拖拉拉，即使不得已去做，文档质量也不高。

这让我感到惊讶，因为在另外一家SaaS企业我也看到听到类似的现象。那么是不是可以推论，这是软件开发公司的一个普遍现象呢？

这样的一个普遍现象，他的深层次原因是什么呢？我们简单做一分析。

首先是软件工程师价值取向。从享受可见成果来说，显然当你开发的功能模块上线时，开发者有成功的满足感，会给枯燥的开发过程平添绚丽的色彩，是人性的自然取向。而文档工作是开发的收尾，相对来说它的成果不是那么显性，开发者不能获得成功的快感。

其次是公司的考核取向。通常公司会把新功能模块的按时成功上线作为开发工作的重要里程碑，大家卯着劲要实现这个里程碑式的目标。而文档工作就没有时间和质量的明确要求，因此开发者自然就会懈怠。

第三，就像一个勇敢的战士冲锋陷阵，战绩赫赫，但他却很难明白能够取得胜利的战略战术。开发者也同样有类似的情景，他可以写出代码，实现功能，但不一定能清楚地明白外部的场景和内在的逻辑，更不用说交出一份高质量的说明文档了。

第四，如今的工科男重理轻文，很多人不注重作文写作，对写作文有着天然的恐惧和抵制；即使勉强写出来，也是文不对题，逻辑不通，详略失当，让读者不明所以。茶壶煮饺子，肚里有，倒不出的主儿有的是。

图片来自网络

作为软件企业，尤其是开发部门的领导，面对这样的普遍现象，应该采取什么举措来改变呢？

首先是价值观和文化建设，要让客户价值最大化的理念深入到每个员工的骨子里，产品的可用性、易用性、可靠性和用户体验是一个软件企业能否生存和发展的生死攸关的关键要素。

第二，要有工匠精神，要对产品的整个生命周期负责，要像玉雕大师那样，既认真雕刻美玉，同时也要为精美的玉雕配上高档的紫檀底座，让二者相得益彰。

第三，在管理考核上，要把新功能模块上线与文档输出捆绑在一起作为里程碑，负责质量控制的测试部门不仅测试产品功能、性能、bug，同样要检验文档质量，严把质量控制这一关。

第四，在布置开发任务时，要有意识地让开发者明白业务应用场景以及可能给客户带来的价值，使他们在潜意识里把自己的工作与实现客户价值建立链接。

第五，在选人用人上注意选用文理平衡，技术精湛，逻辑清晰，表达明白的人才，找那些又能练又能说的“好把式”。

还有一个全局性、长期性的期望，中小学教育文理偏科的弊病要想办法根治。

抛砖引玉，请说说您的看法。

2019年2月27日

于北京观棠斎

  相关文章  

1. SaaS企业研发部是成本中心还是利润中心？

2. 职场第一课：向老板学习

3. 制定业务计划攻略

4. SaaS企业，向左走？向右走？

5. SaaS企业私有部署部门的运营

6. SaaS企业：私有云业务从线索到回款(L2C)全流程管理

7. SaaS企业：私有部署那些大坑

8. SaaS企业：跨越私有部署那些大坑