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