ハンドブックについて
ハンドブックの歴史
ハンドブックは、GitLab がわずか 10 人の会社だった頃に、情報共有を効率的かつ容易にするために始まりました。 将来 GitLab にジョインするチームメンバーは、自分が入社する前に送られていたプロセス変更に関するメールを見ることはできず、また最終的に GitLab に参加する人々のほとんどは、その時点では私たちのことを聞いたこともないであろうと、私たちは分かっていました。 ハンドブックは、いつチームの一員になったかにかかわらず、すべての会社情報を誰もが利用できるようにするための私たちの手段だったのです。
利点
GitLab のハンドブックは広範囲にわたり、それを常に最新の状態に保つことは全員の仕事の重要な一部です。 これは私たちが何者であり、どのようにコミュニケーションを取るのかを支える不可欠な要素です。 以下のメリットを見出したからこそ、私たちはこれらのプロセスを確立しました。
- 読むことは、聞くことよりもはるかに速い。
- 読むことは非同期であり、相手を中断させたり、相手が応じられるまで待ったりする必要がない。
- 私たちが何を大切にし、どのように運営しているかが外部から見えれば、タレントアクイジションが容易になる。
- 入社前に何に飛び込むのかが分かっていれば、定着率が高まる。
- 関連情報がすべて明文化されていれば、オンボーディングが容易になる。
- 会社の他の部門がどのように動いているかを読めれば、チームワークが容易になる。
- 現在のプロセスを読めれば、変更点の議論が容易になる。
- 差分を指し示すだけで済めば、変更の伝達が容易になる。
- マージリクエストを通じて変更を提案することで、誰もが貢献できる。
ハンドブックを初めて目にする人がよく口にする懸念の一つに、厳格な文書化が会社をより硬直的にするのではないか、というものがあります。 実際には、現在のプロセスをハンドブックに書き下すことで、コントリビューターが変更を提案できる力を得るという効果があります。 その結果、このハンドブックは硬直からは程遠いものになっています。ハンドブックのコミット一覧 を見れば、その証拠が一目で分かります。あらゆるガイドラインやプロセスをハンドブックに文書化するよう努めていますが、起こり得るすべての状況やシナリオを文書化することは不可能です。ハンドブックに記載がないからといって、それが許容されているわけではありません。GitLab は各チームメンバーの懸念や状況を現地の法令に基づいて個別に精査し、最善の結論を出したうえで、それに応じてハンドブックを更新します。質問がある場合は、マネージャーに相談するか、People Success チームまでお問い合わせください。
ハンドブックの解釈
ハンドブックは解釈の対象となります。私たちは混乱や誤読を最小限にするため、できる限り明確に書くよう努めています。また、グローバルな読者を抱えており、それが異なる解釈をもたらし得ることも認識しています。質問やさらなる明確化が必要な場合は、該当ページのコンテンツオーナーにご確認ください。迷ったら、気軽に声をかけて質問してください。
GitLab では すべてはドラフト であり、変更の対象であることを忘れないでください。これはハンドブックも例外ではありません。
ハンドブックのページ数を数える
ハンドブックが大きいのは容易に分かりますが、どれだけ 大きいのか考えたことはありますか？ ハンドブックは 2,000 ページを超えます。実に多くの有益な情報です！
単語数とページ数の推移
about.gitlab.com/handbook
| 日付 | 単語数 | ページ数 | 備考 |
|---|---|---|---|
| 2018-01-01 | 298,806 | 228 | |
| 2018-10-01 | 427,929 | 335 | |
| 2019-01-01 | 520,519 | 439 | |
| 2019-04-01 | 656,668 | 586 | |
| 2019-07-01 | 818,064 | 766 | |
| 2019-10-01 | 987,397 | 884 | |
| 2020-01-01 | 1,204,642 | 1,035 | |
| 2020-04-01 | 1,491,017 | 1,222 | |
| 2020-07-01 | 1,851,350 | 1,488 | |
| 2020-10-01 | 2,166,627 | 1,759 | |
| 2021-01-01 | 2,410,554 | 1,914 | |
| 2021-04-01 | 2,615,372 | 2,056 | |
| 2021-07-01 | 2,956,781 | 2,271 | |
| 2021-10-01 | 3,138,952 | 2,355 | |
| 2022-01-01 | 3,280,108 | 2,395 | |
| 2022-04-01 | 3,474,993 | 2,553 | |
| 2022-07-01 | 3,628,280 | 2,641 | |
| 2022-10-01 | 3,732,384 | 2,724 | |
| 2023-01-01 | 3,732,186 | 2,722 | ⬅️ Last entry before migration |
| 2023-07-01 | 3,905,979 | 2,743 | |
| 2023-10-01 | 3,478,407 | 2,306 | |
| 2023-12-22 | 0 | 0 | ⬅️ Handbook Migration Complete |
handbook.gitlab.com/handbook
| 日付 | 単語数 | ページ数 | 備考 |
|---|---|---|---|
| 2023-07-01 | 150,732 | 133 | |
| 2023-10-01 | 1,909,139 | 1,403 | |
| 2024-01-01 | 3,631,360 | 3,003 | ⬅️ Migration Completed |
| 2025-01-03 | 5,129,952 | 3,823 | |
| 2025-12-11 | 5,129,807 | 4,022 | |
| 2026-01-01 | 5,137,908 | 4,040 |
測定方法
単語数とページ数は、シンプルな 2 ステップのプロセスで算出します。
- ハンドブックの単語数を数えます。リポジトリのルートから
find sites/handbook/source/handbook -type f -name "*.md" -o -name "*.md.erb" | xargs wc -wを実行することで求められます。 - ハンドブックのページ数を数えます。リポジトリのルートから
grep -l -r "\" * | wc -lを実行することで求められます。
注記: 以前のバージョンのハンドブックに遡る必要がある場合は、戻りたい日の翌日を指定して git checkout `git rev-list -n 1 --first-parent --before="2021-07-02 00:00" master` を使ってください。
統計を見る
このページでは、ハンドブックのトレンドを確認したり、あまり知られていない人気ページを発見したりできます。
GitLab はハンドブックの利用状況の追跡に Snowplow を使用しており、情報は Tableau で確認できます。
ハンドブックについてのさらなる情報
このページでハンドブックに関する 一部 の情報を集めていますが、他にもさらに情報があります。
原文: https://handbook.gitlab.com/handbook/about/ · 翻訳: 2026/4/19