保持/管理组织业务活动知识的最佳做法

Question

这是一个更广泛的问题，我认为每个组织/企业一旦遇到不止一个DevOps人员，就会遇到这样的问题:如何保持和管理组织操作知识，使其保持最新、易于访问，并对新来的人有用？

这个问题的目的是收集一个解决方案的样本，供人们选择。我的企业/组织还没有找到处理这个问题的好办法。

定义:操作知识--需要知道什么才能完成任务，保持基础设施运行，并保持最新。

一些例子:我们的主要RDS集群是哪些AWS区域？我们要把我们的秘密藏在哪里，怎么藏？我们的网页的负载平衡设置是什么？我们在Postgres中的角色/用户结构是什么？VPN的设置如何?添加新用户需要什么(生成证书等)？将新版本的代码XYZ部署到生产中的步骤是什么？

您的组织是如何处理这一问题的？你是否运行你自己的wiki (哪一个？)，Github的wiki，Google文档，Evernote，git回购中的标记文件，Word docs (?!?)在中央服务器上，还是别的什么？

Answer 1

有些组织从知识库的wiki开始。对于一个小团队来说，保持跟踪是非常容易的，并且不需要花费太多的精力来构建。了解某种标记语言是有帮助的，尽管有一些网页面板可以将发布过程简化为一个创作页面。

有一种使用谷歌文档的趋势，因为它是共享的，协作的，可以组织的。这在一开始很好，但很容易出现混乱，而且搜索功能不能很好地处理大型和老化的数据集(错过了相当多的数据集)。但如果你能让它井井有条的话，它又便宜又简单。这实际上和NAS的“文件柜”方法是一样的，并且通常会存储您需要它的任何东西。

像Confluence这样的文档管理平台对较大的组织很好地工作，因为它的目的是将维护文档的职责分离到团队之间，以及提供清晰的版本控制和共享功能。它很容易保持组织，并与各种图表或其他丰富的内容系统集成。与wiki或经典的“文件柜”方法相比，还有更多的学习曲线。

Answer 2

一旦你的团队超过了3到4个人，你就需要一个图书馆员--一个负责确保文档编写、一致和维护的人。这显然不是一份全职工作，但这很重要。当没有人负责维护文档/wiki/存储库/Sharepoint时，文档就过时了。一旦它过时了，人们就会停止使用文档/存储库，而这些东西就会留在人们的脑海中。