即使在一些有着稳健和健康的文档编写文化的组织中，运用的进化和修正速度也会远远快于文档编写速度。实际情形是软件变更速度远远快于文档编写速度，即使有主动化文档体系，有时刻我们仍然须要人工编写一些文档。这种文档须要经由过程必定的技巧转换，方能供给给在特别浏览情况中的读者浏览，是以无法经由过程主动化办法保护。

API参考文档以及其他高度技巧化的文档，则很可能经由过程编程说话平台的主动化文档编写机制完成(如Java的 Javadoc、Ruby的RDoc Python的 Pydoc等)。然而，有些须要人类表达(这是最名贵的交换方法)的文档，则不像技巧文档一样与运用法式和基本架构有慎密关系。为此，技巧文档可能在一个月内(或更短的时光内)就会过时，而有一些文档可能几年时光都不曾更新过一一不外，这种情形现实上比没有技巧文档还要槽，因为会进上程帅认为不须要从别处获守信息，而误以为这些过时文档就是准确的信息。

除此之外，当文档创立后，很多工程师就不会再更新文档了。按期检讨文档能力让文档坚持最新状况。

解决办法:通知工程师更新文档

在全部组织规模内，人们不太可能具体浏览文档治理体系(如Wi) 中的所有文档，但在一个部分级别上，却可能会涌现一些文档修正和编纂。然则，应用随机办法的效力是远远不敷的，我们必需经由过程某种机制，让文档治理体系可以或许通知文档所有人或治理员，让他们在一段时光后更新文档。开源Wiki体系 Twiki提出了一种解决计划，它的页面像报纸一样在时光长了之后会变黄。并且，在体系以为文档可能须要更新时，它会向文档所有人发送一封通知邮件。

但只有对象还不敷，运维与开辟团队还必需改变熟悉，他们必需将应用文档视为一种软件改良手腕。例如，须要更新的页面会酿成黄色但这并不料味着有人会去更新它。必需有人去响应这个通知，假如吸收者不睬解创立及保护文档对于代码和体系的价值，那么这个响应可能就不会涌现。假如技巧人员知道当文档须要更新时，体系才会通知他们，那么当他们吸收到一个通知时，他们就很可能会跟进处置这个通知。这似乎有一些琐碎，然则对技巧人员予以告诉可以勉励他们卖力看待文档。

利益:将文档整合到惯例运动中

当网站设计开辟人员习惯了吸收更新通知并响应这些通知之后，他们就会看到文档在改良软件方面的价值，如许将进一步鼓励他们实时响应通知。组成年夜型网站基本架构的软硬件平日由必定数目的位于数据中间内的办事器构成。今朝，这些基本架构的安装及保护在必定水平上仍然经由过程人工方法完成。我们将介绍跟着盘算范畴内的冲破性进展，虚拟化基本架构是若何削减人工需求的，以及若何实现个中一些流程的主动化。不外，在斟酌实行主动化之前，最好先懂得一下当前的工作流程。