スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro

ドキュメント文化は健全な組織のスケールのために必要 組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケールしやすくなる。過去の結論にアクセス可能になるので、議論を積み上げていき、意思決定のクオリティを高めることにもつながる。そもそも何かを読むということは何かを聞いて教わるよりも時間あたりの処理量が多いし、非同期に実施できる。良いドキュメントをアセットとして社内に蓄積していくことはスタートアップのみならず、ありとあらゆる組織が成長していく上でとても重要であると言える。 しかしその一方で、良質なドキュメント文化を徹底できている会社は多くないように見える。例えば、社内のドキュメントを蓄積させていく場所とし

[dh16t]

仕事でドキュメンテーション軽視されがちなのイラつくんだよなあ。ノウハウ溜める習慣ない人も多いし。

[OrionB312]

こういうのほんと弱い。人の頭の中にしか残ってないからいちいち聞かないとわからないし、新規参入者からすると過去の経緯さっぱりわからんし。ちゃんとやらなきゃなぁ…

[takatama]

GitLab Handbookの存在は知っていたけど、ちゃんと読む胆力は無かったのでありがたい。Gitを使って管理するのは情報を最新にする効果があるけど検索可能にするのがむずいんだな

[laislanopira]

自社もそうだが、文書が残らないプロジェクトや組織は恐ろしい（霞が関の方を見ながら） / wikipediaでも一度立った記事を抜本的に書き直すことはほとんどない

[mitswku]

“FileVault”

[hara_boon]

これはすごいなー

[inductor]

いい話だー。オンボーディングにおいてもドキュメントがあるかないかでだいぶ違うよね

[Nnwww]

めちゃくちゃ憧れる。ドキュメントは組織の取扱説明書を目指すべきだと言うが、その意味においてこれは理想の体現だと思う。

[SWIMATH2]

すごすぎ/あとで読みたい

[inikot]

gitで管理されたこんな感じの共有医療メモが有ればいいなと思ってるんだけど

[nilab]

スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro｜note

[luccafort]

“#donut-be-strangersチャネルに参加するとweeklyで1回、ランダムなコーヒーブレイクコールがセットされるようになる”面白い。

[bulldra]

“そして移動先のパブリックチャネルでこの文章を言えと明示「@Person がDMで質問してきたから、みんなの意見が反映できるようにここに書くね」”

[ten-gallon-Mouse]

“織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明が

[mohri]

「WikiではダメでGitリポジトリじゃないとスケールできない」というの、これがGitリポジトリを提供している会社だからじゃないだろうか……という気はする

[s99e209]

斜め読みしてみたけどすごい内容だった。ティールの思想を実務に落とし込むときの参考になりそう。

[yatmsu]

素晴らしい。

[ikajigoku]

すごすぎる

[shag]

gitlab のリポジトリに付属してくる wiki 機能は試したことあるけど、なんか違うんだよな。

[hirose30]

このカルチャーにマッチできる人を選び出す、面接方法が気になる。それもハンドブックに載っているのかな？

[rlho]

徹底的に組織を効率化しててめっちゃおもしろいな…そして成り立つのすごい。給与決定の考え方さえもオープンにしてるのさすが

[blueribbon]

・（ドキュメントがあることで）過去の結論にアクセス可能になり、意思決定のクオリティを高めることができる ・何かを読むということは時間あたりの処理量が多く、非同期に実施できる ・「ハンドブックファースト」

[nc44v-134-nvtyqfgq]

gitlabぱねぇ

[nishiotsutomu]

これは凄い

[decobisu]

すごいカルチャーだ

[kzm1760]

徹底していて素晴らしいな。ドキュメントが散らばらなくて良さそう。

[field_combat]

確かにWikiは維持するの大変だしな。ここにたどり着くまでに多くの試行錯誤があったと思うとありがたい。

[hidecharo]

🌀💫🤍👍💙✨🌠⚡🚀🙏🎉🌀

[yutaka_maruoka]

こいつぁすげえや！

[teckl]

ここまでドキュメント化するの、凄すぎる。障害対応を中継したり、とことんDMを使わせないようにして何でもオープンにするところとか、ここまで出来るのか…

[do_su_0805]

面白かった。給料設計に関連して人事の話に触れたり、リモートワーク仕草なども触れられてた。Handbook自体も見てみよう

[bopperjp]

gitlab はマジですごい。ドキュメントもgitlab自体の設計もイケてる。

[mizoguche]

“Wikiでは、……提案を取り込むべきか取りこまないべきかの議論もできない。そのため、……リファクタリング不能な状態に陥る。”

[nikutaiha]

組織

[yarumato]

“評価と給与についてもGitLabは高いオープンネスを維持している。報酬の計算式は極めて単純明快。サンフランシスコの給与水準×そこと地域の報酬水準比較…で決定。つまり引越しをすると給与は変わる”

[akiramaz]

勉強になる

[golden_eggg]

良い。同意しか無い