假设一家大型企业在（此处插入随机位置）开设了新办事处，并希望新同事尽快上手。假设这家企业非常典型，环境复杂，历史悠久，文档几乎完全缺失。
已经决定的是，新同事将获得最典型任务的操作指南文档，并将获得一些更复杂系统的架构文档。
有什么关于改进此过程的想法吗？更具体地说，这样的操作文档应该是什么样子才有用？
答案1
我会花时间编写一份文档，全面概述他们所在领域的所有主要组件。然后他们可以将其用作参考，并概述他们可能需要学习的内容。例如，如果您有大型集群设置，请绘制这些集群的图片。如果他们是网络管理员，至少要绘制一张公司网络的详细图表。
从那里开始，我会开始记录环境中任何不寻常的事物，然后记录任何特别先进或复杂的事物。
如果这些是较低级别的职位，他们将主要执行重复性任务，那么这些操作指南对我来说是有意义的，但如果他们是更高级的职位，那么结合我所描述的不寻常/复杂的文档的总体情况是最有意义的。
答案2
我在办公室建立了一个 wiki，以便在开发人员有时间写东西时记录知识片段。老板只允许“完整无缺的文档”，所以他想要使用 sharepoint。由于没有开发人员有时间写“枯燥无味的完整文档”，所以没有写文档，而且由于 PHB 禁止使用 wiki，我们又回到了几年前的状态。
答案3
如果系统有适当的文档记录，则无需额外的步骤。任何称职的系统管理员都应该能够根据系统文档确定需要做什么以及如何做，尽管经验丰富的员工的演练当然会让事情变得更简单。
如果系统有正确的文档记录，那么整个 IT 人员都可能被这辆众所周知的巴士碾压，而新员工应该能够在没有帮助的情况下快速上手。如果您的组织中没有这种情况，则需要紧急纠正。
答案4
首先创建一个内部 wiki，然后将其作为记录的地方。我在工作中已经这样做了一段时间，那里的信息会根据需要逐渐出现。