TOP > ネタ・話題 > スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro|note

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

162コメント 2020-02-14 16:17  note

ドキュメント文化は健全な組織のスケールのために必要  組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保でき...

ツイッターのコメント(162)

ドキュメント文化 (と情報の透明性) が大事って色んなとこで言ってるマンなんだけど、やっぱ組織適正(能動的に調べることが出来る + ログを残すことに抵抗がない人員で構成する) が多大に影響するんだろうなぁって思ってる
ウチの会社でもこういうのやる。
今日、同僚から教えてもらったリモートの鬼ルールが面白い

・ビデオチャット中に、積極的に子供やペットが画面に映り込むようにしろ(これは想像の逆でおもしろい、やはりリモートだと積極的な雑談のきっかけを作っていかねばならないということなのだろうか)
むっちゃ良い内容だった。 Handbook読んだ方がいいなこれ
非同期コミュニケーションのTips



「こんにちは」とだけ書いて送るな。直接の質問だけをしろ。

> 同期コミュニケーションの方が良い場合もありますが、それをデフォルトにしてはいけません。

誰かが何かを尋ねてきたときは、期限や自分がやったことを返してください。
Gitでドキュメント管理するの良いなと思う。差分が明確で履歴もしっかり残る。GitHubやGitLabを使えば、変更についての議論も残るし、承認プロセスにもなる。
テックリードがtimesで共有してた記事が良かった。
"ドキュメント文化は健全な組織のスケールのために必要"
社内のドキュメント管理問題はリモートワークに移行して顕在化してきている課題だと思っておりますが、Git Labさんのアプローチが非常に学びになる。フルリモート組織の教科書のような組み方だと思う。

OktaとJump Cloudでオンプレのサーバーも一切持たないらしい。
ドキュメントって難しいよな
書かないとだめ。だけどあるだけあっても意味がない。wikiとかパワポとか関係なく、多分整理・管理する技術が必要。
「WikiではダメでGitリポジトリじゃないとスケールできないと理解する」「ハンドブックはリファクタリング不能な状態に陥る」 /
>・ビデオチャット中に、積極的に子供やペットが画面に映り込むようにしろ
こりゃあなかなか・・。
社内wikiに対する考え方の、日本語のドキュメントってあまり見かけないので、非常に参考になります。

@takahiroanno
報酬計算までYAML化されている。すごい。

@takahiroanno
がこんなにヤバイ会社だったとは…
GitLabのドキュメンテーション技術。
ビデオ会議、給与決定、新入社員のオンボーディングにも言及されていて、非常にためになります。
読む、読む。

『 Handbook”から学ぶ』
合理的すぎてすごい... フルリモート組織 @takahiroanno
gitlabしゅごい。
GitLabのドキュメンテーション文化すごすぎる
ドキュメントをwikiじゃなくてgit管理するのもカルチャーのスタンプをつくるのも、オープンさも真似したいポイント

Anno @takahiroanno
@yonemura2006 1000人規模でフルリモートで仕事している GitLabでは、プライマリーにSlack、セカンダリーにZoomやGoogle Chatを用意しておき、プライマリーが落ちた時にスイッチすることがガイドラインに書いてあるそうです🤔
GitLabハンドブックが組織づくりの参考になりすぎて毎日読み進めてるマン。会社を1つの製品としたときのPRD(製品要求書)とした時にコミット数からしてまじでLivingすぎる。
すごいなこれは
ドキュメント文化最高
wikiがgit管理されていることの重要性っていのがポイントだなぁ.. これは実践してみたい

@takahiroanno
フルリモートのGitLabが公開している Handbook から、いくつか重要なポイントを抜粋している良記事でした

スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro @takahiroanno
Handbookすごいなこれ。
スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro @takahiroanno
給与計算方法が明確で社員のみならず誰でも見れるのがすご
あと新入社員にやってもらうリストがめっちゃ参考になる
超ハイパーベリーインポータント良ドキュメント
やはりGitLabのスタイルから学べるところ学び尽くした方がいい気がしていて、ちょっと時間とって研究したい
TABICAのAIこと開発責任者から教えてもらった。

生産性好きには、よだれ出る文書。
ぼくの生活にほぼ縁のない話だけど、面白いにゃあ:「 Handbook”から学ぶ」
このカルト的なまでのopenessとかmeetingへの姿勢とか、凄く個人的に好み。
他にも色々書いてあるのでぜひ・・
・Slackには90日間のアクティビティしか残さない→記録は別の所に残す。Wikiも形骸化しやすいので分散バージョン管理システムを利用(Gitリポジトリ)
これほっこりするのでみんなやってほしい。「ビデオチャット中に、積極的に子供やペットが画面に映り込むようにしろ」
Handbook は凄いよね
スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro @takahiroanno
新しい会社ではドキュメント文化は浸透させたい。
リモートワークルールとかも作らんとなあ。
システム側もシステム概要図などドキュメント整備しながら開発体制整える所存。
後続で入ってくれるエンジニアのためにも。
障害対応YouTubeでライブ配信するの凄いな
やってみたいなー。
@takahiroanno 頭が動いてない時に読んだんですけど、とても良くて参考になることも多いと思います。ぜひ(語彙力
以前これ読んだときに強く思ったけど、徹底的な見える化には是非挑戦していきたい。
リモートワークといえばこちらも
いつ、どこで、誰が入ってきても会社のカルチャーや業務内容を把握できるドキュメンテーション文化があれば究極仕事は全てリモートで完結すると思っている
Gitlab社面白いな!確かに大規模障害の時に、YouTubeで障害対応の様子を中継していたね。

いわゆるティール組織なんじゃなかろうか。
1000人規模でシンプルな思考とリモートワークに対する理解のある社員がいないとなあ。。。まずは自分から意識しよう。/ @takahiroanno
もっと見る (残り約112件)
 

いま話題のニュース

もっと読む

 
PR