ハンドブックの方向性
概要
GitLab ハンドブック は、プロセス、ポリシー、製品の方向性を含め、私たちが GitLab でどのように業務を行っているかについての唯一の信頼できる情報源です。私たちの透明性という価値観に沿って、GitLab ハンドブックは世界に対して完全にオープンです。コミュニティからのフィードバックを歓迎しており、現在および将来の他の企業のインスピレーションになれば幸いです。GitLab ハンドブックは、候補者に GitLab が企業としてどのように運営されているかについての貴重な洞察を提供する、素晴らしい人材獲得ツールでもあります。
handbook.gitlab.com ウェブサイトのサブセクションである GitLab ハンドブックは、特にウェブサイトの /handbook/ ネームスペース内のコンテンツを指します。GitLab ハンドブックの全体的なユーザーエクスペリエンスとアーキテクチャは共有責任です。フィードバックや質問は、#handbook Slack チャンネルにお寄せください。
対象読者
GitLab チームメンバー: すべての GitLab チームメンバーには、ハンドブックを使用し更新する責任があります。これはプロセスドキュメントと製品の方向性に関する中央リポジトリです。
リーダーシップ: GitLab のリーダーシップは、他のチームメンバーと同じようにハンドブックを使用しますが、加えてステークホルダーや投資家へのプレゼンテーション中にコンテンツを参照する必要があります。私たちが行うすべてのことは公開されているため、GitLab 外のリーダーシップチームのメンバーも、自身のチームのプロセスやポリシーの参考やインスピレーションとして GitLab ハンドブックを使用することがあります。
応募候補者: GitLab の求人候補者は、ハンドブックを使用してその役割への期待、報酬、福利厚生、GitLab の企業価値観、その他のポリシーについて学びます。GitLab チームメンバーも、応募候補者と特定の関連情報を共有するためにハンドブックを広範に使用しており、それ自体が強力な人材獲得ツールとなっています。
現在および見込みのユーザー: GitLab の製品の方向性、戦略、ビジョンは、製品およびエンジニアリングプロセスとともにハンドブックに文書化されています。これにより、現在のユーザーは GitLab の今後の優先事項を垣間見ることができ、見込みのユーザーが GitLab をツールとして採用するかどうかについて情報に基づいた判断ができるようになります。
私たちの目指す方向
GitLab では、非同期でのコラボレーションとドキュメンテーションを促進するために、誰もがハンドブックファーストで働くことを推奨しています。この働き方には、変更を加えるのに必要な時間と労力という、決して小さくない課題があります。この余分な投資は、コントリビューターが変更をより慎重で意図的なものにするよう促すことができますが、ある時点で意味のあるコラボレーションを妨げ、私たちの目標に反することになります。
私たちは、GitLab ハンドブックを他の人が真似したくなるものにしたいと考えています。それを実現するために、すべてのユーザーがハンドブックを簡単に使用および更新できるようにしたいのです。理想的には、ハンドブックは以下を備えています：
- 整理された、最新のコンテンツ
- 高速で予測可能なデプロイ
- クリーンでスケーラブルな情報アーキテクチャと最新のコードベース
次に何を、なぜ行うか
私たちはハンドブックの高速（パイプライン10分以下）かつ安定した（パイプラインの失敗を最小限に抑える）状態の維持に注力しています。
それ以外の事項は検討中です。
フルタイムの DRI がいないため、以下は保留中です：
- 読書および共有体験の改善: コンテンツが主な焦点であり続ける必要がありますが、検索、ナビゲーション、共有がより簡単になるべきです。
- フレッシュネスツール: コンテンツが関連性があり、最新で、重複していないことを保証し、これらの基準を満たさないコンテンツにフラグを立てるために必要なツールを読者に提供すること。
- その他の Issue: ハンドブック Issue
現時点で計画していないこと
私たちは現在、別の外部のコンテンツ管理システムやパブリッシングプラットフォームへの移行を検討していません。
GitLab ハンドブックのニーズはウィキ（や類似の）製品で扱える範囲を超えているため、コンテンツをそのフォーマットに移行する計画はありません。
コンテンツは文字通り毎日変化しているため、GitLab ハンドブックのコンテンツからデジタルまたは印刷された書籍を生成することは検討していません。
GitLab ハンドブックは現在、Stack Overflow で見られるような、検索可能なナレッジベースや FAQ リポジトリとして機能するように最適化されていません。
