サクサク読めて、アプリ限定の機能も多数！アプリで開くはてなブックマーク閉じる ●はてなブックマークって？●アプリ・拡張の紹介●ユーザー登録●

●ログアウト

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

テクノロジーカテゴリーの変更を依頼記事元:

note.com/takahiroanno

692 usersがブックマークコメント

61

現在プライベートモードです設定を変更する

692 users note.com/takahiroanno

現在プライベートモードです設定を変更する

みんなの興味と感想が集まることで新しい発見や、深堀りがもっと楽しくアカウントをお持ちの方はログインページへ

記事へのコメント61件

●注目コメント ●新着コメント

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

OrionB312 こういうのほんと弱い。人の頭の中にしか残ってないからいちいち聞かないとわからないし、新規参入者からすると過去の経緯さっぱりわからんし。ちゃんとやらなきゃなぁ… 2020/02/15 リンクその他 ● ● ●

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

laislanopira 自社もそうだが、文書が残らないプロジェクトや組織は恐ろしい︵霞が関の方を見ながら︶ / wikipediaでも一度立った記事を抜本的に書き直すことはほとんどない ●組織 ●技術 ●仕事 ●参考 2020/02/15 リンクその他 ● ● ●

mitswku “FileVault” 2020/02/16 リンクその他 ● ● ●

hara_boon これはすごいなー 2020/02/15 リンクその他 ● ● ●

inductor いい話だー。オンボーディングにおいてもドキュメントがあるかないかでだいぶ違うよね 2020/02/15 リンクその他 ● ● ●

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

SWIMATH2 すごすぎ/あとで読みたい ●ドキュメント 2020/02/15 リンクその他 ● ● ●

inikot gitで管理されたこんな感じの共有医療メモが有ればいいなと思ってるんだけど 2020/02/15 リンクその他 ● ● ●

nilab スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro｜note 2023/03/07 リンクその他 ● ● ●

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

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

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

mohri ﹁WikiではダメでGitリポジトリじゃないとスケールできない﹂というの、これがGitリポジトリを提供している会社だからじゃないだろうか……という気はする 2020/03/22 リンクその他 ● ● ●

s99e209 斜め読みしてみたけどすごい内容だった。ティールの思想を実務に落とし込むときの参考になりそう。 2020/03/13 リンクその他 ● ● ●

yatmsu 素晴らしい。 ●.tech ●.document 2020/03/03 リンクその他 ● ● ●

ikajigoku すごすぎる ●Business ●Work 2020/03/03 リンクその他 ● ● ●

shag gitlab のリポジトリに付属してくる wiki 機能は試したことあるけど、なんか違うんだよな。 2020/02/27 リンクその他 ● ● ●

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

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

blueribbon ・︵ドキュメントがあることで︶過去の結論にアクセス可能になり、意思決定のクオリティを高めることができる・何かを読むということは時間あたりの処理量が多く、非同期に実施できる・﹁ハンドブックファースト﹂ ●Git ●企業 ●document ●management ●技術 ●ポイント ●事例 2020/02/20 リンクその他 ● ● ●

nc44v-134-nvtyqfgq gitlabぱねぇ 2020/02/20 リンクその他 ● ● ●

nishiotsutomu これは凄い 2020/02/19 リンクその他 ● ● ●

decobisu すごいカルチャーだ 2020/02/17 リンクその他 ● ● ●

kzm1760 徹底していて素晴らしいな。ドキュメントが散らばらなくて良さそう。 2020/02/17 リンクその他 ● ● ●

field_combat 確かにWikiは維持するの大変だしな。ここにたどり着くまでに多くの試行錯誤があったと思うとありがたい。 ●組織 ●ドキュメント 2020/02/17 リンクその他 ● ● ●

hidecharo 🌀💫🤍👍💙✨🌠⚡🚀🙏🎉🌀 ●Documents ●Managements ●Design ●Dev ●Web ●DeepLearning ●QuantumComputer ●Flutter ●Firebase ●Frontend 2020/02/16 リンクその他 ● ● ●

mitswku “FileVault” 2020/02/16 リンクその他 ● ● ●

yutaka_maruoka こいつぁすげえや！ 2020/02/16 リンクその他 ● ● ●

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

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

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

bopperjp gitlab はマジですごい。ドキュメントもgitlab自体の設計もイケてる。 2020/02/15 リンクその他 ● ● ●

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

nikutaiha 組織 2020/02/15 リンクその他 ● ● ●

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

akiramaz 勉強になる 2020/02/15 リンクその他 ● ● ●

SWIMATH2 すごすぎ/あとで読みたい ●ドキュメント 2020/02/15 リンクその他 ● ● ●

golden_eggg 良い。同意しか無い 2020/02/15 リンクその他 ● ● ● 注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の﹁建設的コメント順位付けモデルAPI﹂を使用しています

リンクを埋め込む

以下のコードをコピーしてサイトに埋め込むことができます

<iframe marginwidth="0" marginheight="0" src="https://b.hatena.ne.jp/entry.parts?url=https%3A%2F%2Fnote.com%2Ftakahiroanno%2Fn%2Fn62b962e021d6" scrolling="no" frameborder="0" height="230" width="500"><div class="hatena-bookmark-detail-info"><a href="https://akarinohon.com/text/taketori.cgi/https://note.com/takahiroanno/n/n62b962e021d6">スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro</a><a href="https://akarinohon.com/text/taketori.cgi/https://b.hatena.ne.jp/entry/s/note.com/takahiroanno/n/n62b962e021d6">はてなブックマーク - スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro</a></div></iframe>

プレビュー

はてなブックマークボタンを作成して埋め込むこともできます

規約違反を報告

いまの話題をアプリでチェック！ ●バナー広告なし ●ミュート機能あり ●ダークモード搭載アプリをダウンロード

usersに達しました！

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