組織の運用知識を維持/キュレートするためのベストプラクティス
これは、複数のDevOps担当者がいると、すべての組織/ビジネスが直面していると思うトピックについてのやや広い質問です。組織の運用知識を維持およびキュレートして、最新の状態を保ち、簡単にアクセスでき、役立つようにする方法新規参入者に？
この質問の目的は、人々が選択できるソリューションのサンプルを収集することです。私のビジネス/組織は（まだ）この問題に対処する良い方法を見つけていません。
定義：運用知識-物事を成し遂げ、インフラストラクチャを実行し続け、最新の状態に保つために知っておくべきこと。
いくつかの例：メインのRDSクラスターはどのAWSリージョンにありますか？秘密をどこにどのように保存しますか？ Webページの負荷分散の設定は何ですか？ Postgresでの役割/ユーザー構造は何ですか？ VPNの設定はどのように行われ、新しいユーザーを追加するために何が必要ですか（証明書の生成など）？新しいバージョンのコードXYZを本番環境にデプロイする手順は何ですか？
あなたの組織はこれをどのように処理していますか？独自のウィキ（どれですか？）、Githubのウィキ、Googleドキュメント、Evernote、gitリポジトリのマークダウンファイル、中央サーバーのWordドキュメント（？！？）、または他に何を実行していますか？
一部の組織は、ナレッジベースのwikiから始めます。少人数のチームで追跡するのは簡単で、構築するのにほとんど労力を必要としません。ある種のマークダウン言語を知っていると役に立ちますが、公開プロセスをオーサリングページに減らすWebパネルがあります。
Googleドキュメントは共有され、共同作業され、整理できるため、Googleドキュメントを使用する傾向があります。これは最初はうまく機能しますが、混乱する傾向があり、検索機能は大規模で古くなったデータセットではうまく機能しません（かなり欠落しています）。しかし、整理しておくことができれば、安くて簡単です。これは事実上NAS "ファイルキャビネット"アプローチ」と同じものであり、通常は必要なものをすべて保存します。
Confluenceのようなドキュメント管理プラットフォームは、チーム間でドキュメントを維持する責任を分離し、明確なバージョン管理と共有機能を提供するように設計されているため、大規模な組織に適しています。整理しやすく、さまざまな図表やその他のリッチコンテンツシステムと統合できます。ウィキや古典的な「ファイルキャビネット」アプローチよりも学習曲線があります。
チームが3人または4人を超えると、ライブラリアンが必要になります。つまり、ドキュメントが作成され、一貫性があり、維持されるようにする責任があります。それは明らかにフルタイムの仕事ではありませんが、それは不可欠です。 document/wiki/repository/SharePointの保守に誰も責任がない場合、ドキュメントは古くなります。そして、それが古くなると、人々はドキュメント/リポジトリの使用をやめ、物事は人々の頭の中にとどまります。