最好的Web开辟人员老是可以写出带有好注释的英俊代码，然则，他们一般也不会编写专门给非开辟人员浏览的文档。最好的工程师愿意猖狂地开辟运用法式，然则不肯意花一点时光去编写文档或向其他人解释运用法式。他们以为，代码就是文档，并且有技巧的人都可以或许懂得代码，所以编写额外的文档是在糟蹋时光。

然而，实际情形是，并非所有人都可以或许读懂API或设置装备摆设治理清单。营业用户、项目司理及其他非技巧人员经常须要懂得运用法式的内部工作方法，如许他们能力更好地完成本身的工作，而技巧文档并不克不及知足他们的需求。这些帮助人员是T组织正常运行的主要前提，假如没有这些信息，他们就会觉得被疏远，不知道该若何与开辟和运维团队交换，或者也不知道若何将他们的工作转达给营业部分、项目治理部分或其他非技巧部分。

此外，还有一种托言:因为软件开辟速度越来越快，所以开辟人员和运维人员须要进一步进步临盆力，削减交叉培训、编写文档和内部培训的时光。这同样也是纰谬的。假如没有文档，我们就无法将遗留体系引入组织中。遗留体系平日是每隔几年就须要更新一次，因为知道若何保护这些体系的人可能已经分开公司，或者基本不记得若何保护这些体系，也没有参考材料可以查阅。

解决办法:将文档加到胜利前提中，配合分管文档编写义务

年夜多半基于Web的组织都邑应用一种迅速或精益办法来开辟软件，并且这个进程平日须要按期極查已完成的上作和查对义务履行情形，从而落实项目标进展情形。如许的话，文档就可以整合到开辟与运维团队的文化中，并且组织也可以或许从中获益，例如产出质量更好的代码和发明设计问题等。

这个进程须要治理层的介入能力取得胜利。假如治理层只存眷于完成进度，而不留意形成文档编写文化，那么这种进程是弗成能胜利的。只是认同文档属于软件开辟性命周期的一部门，但不应用需要的文档对象，也不投入时光，那么形成文档编写文化的目的就弗成能实现。

并且，开辟与运维团队都必需介入到文档编写文化的创立进程中，他们必需配合协作，而不克不及各自为政。在一些超年夜型组织中，最好配备一位有开辟或运维配景的全职技巧文档工程师。因为这小我有技巧配景，从而也就不轻易让人疑惑他的专业性。

利益:造就义务意识

配备一位有技巧配景的文档编写人员(技巧文档工程师)有利于勉励开辟与运维团队自动承担起编写代码文档、运用文档和流程文档的义务。一位经验丰硕的技巧文档工程师可以指点他人编写出有用的文档，或者赞助他们养成编写文档的习惯。如许可以赞助否决编写文档的工程师开端接收文档编写工作。

一旦每位网站制造工程师都愿意编写本身的文档，那么技巧文档工程师就可以将脚色从传教师和写手，改变为编纂和指点者，专职负责包管文档的准确组织和宣布，以及赞助工程师改良技巧文档的质量。当然，分歧部分的技巧文档工程师有分歧的职责，这取决于Web营业的组织方法，然则作为文档编写的症结人物，他可以包管文档真正编写完成。