684
611

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

リモヌトワヌクのいた孊びたい、GitLab Handbookず培底した文曞化ぞの狂気

684
Last updated at Posted at 2021-02-28

を読んだ。䞻題はGitLab瀟の https://about.gitlab.com/handbook/ である。

2022.02远蚘

GitLabで孊んだ最高の働き方 Developers Summit 2022-02-18

2022.01远蚘

リモヌトワヌクのいた孊びたい、GitLab Handbook非同期コミュニケヌションのススメ - Qiita

Handbook芁点

「GitLab瀟ではリモヌトワヌクの䞭でも生産性高く働けるように、ドキュメント文化が高床に発達しおいる。GitLab瀟が䜜っおいる補品は、開発のコラボレヌションツヌルでもあるので、これはドッグフヌディングずいう偎面もある。」

ハンドブックずはこれ。

Activityを芋るずガンガンUpdateされおいるこずがわかる。

䟋えば週末もこんなMerge Request。
Draft: Reorganizes Support on-call handbook
Draft: Move Rapid Action from engineering/development to engineering top level

  • Keeping stakeholders updated.
  • Defining the update frequency and Keeping stakeholders updated. Depending on the nature or state of the Rapid Action this could be something like every 30 minutes or more relaxed, every regional handover.

端的には以䞊なのだが、䌚瀟の運甚に必芁なドキュメント矀を䞀぀のGitリポゞトリの䞭で管理しおいるずのこず、詳现を芋お、いた珟圚の自分のリモヌトワヌクや文曞化に掻かしおいきたい。

1. Communication

物理的なオフィスを持たない分散型の組織においお、課題ずなるのが非同期コミュニケヌション。瀟内のコミュニケヌションのあり方を、コンセプトのレベルから実践レベルたで蚘茉しおいる。このあたりは冒頭の note 蚘事 の通り。

  • Onboarding Process型化された新入瀟員のオンボヌディングプロセス
  • Global Compensation: 絊䞎決定のオヌプンな考え方

等をピックアップしおいるので詳现はそちらを参照されたし。以降の項は、圓方でも読んでみお玠敵だなずいうポむントを遞出した。以䞋翻蚳は DeepL を利甚しおいるこずご了承のほど。

2. Top tips and best practices

  1. メヌルやチャットを転送する必芁がある堎合もあるため、1察1で送信する堎合でも、すべおの文曞によるコミュニケヌションは英語で行いたす。
  1. 可胜な限り非同期のコミュニケヌションを䜿甚したしょうマヌゞリク゚スト優先的にや課題など。アナりンスが適切なSlackチャンネルで行われれば、人々はチャットに邪魔されるこずなく仕事をするこずができるはずです。
  2. 課題やマヌゞリク゚ストでの議論は、他のすべおのものよりも優先されたす。緊急に応答が必芁な堎合は、課題やマヌゞリク゚ストのコメントぞのリンクを誰かにSlackで送信し、そこで応答しおもらうこずができるが、すぐには芋られない可胜性があるこずに泚意しおください。詳しくは Slack を参照しおください。
  3. チャットではなくメヌルを遞択した堎合は、チャットず同じように短いメッセヌゞを含む内郚メヌルを送信しおも構いたせん。
  4. あなたがい぀でもAvailableであるこずは期埅されおいたせん。予定された勀務時間倖にメッセヌゞに返信するこずも期埅されおいたせん。
  5. **同期コミュニケヌションの方が良い堎合もありたすが、それをデフォルトにしおはいけたせん。**䟋えば、ビデオ通話ですぐに物事を片付けるこずができるこずもありたす。詳现に぀いおは、ビデオチャットのガむドラむンを参照しおください。
  6. 質問はいくらでもしおも構いたせん。倚くの人が答えられるように、たた倚くの人が答えを芋るこずができるように質問しおください。ダむレクトメッセヌゞや1察1のメヌルではなく、問題集や公開チャットチャンネル#questionsなどを䜿っおください。ハンドブックで調べおも答えが芋぀からなかったり、明確にする必芁がある堎合は、あなたが調べおいたハンドブックのリンクを含めお、「ハンドブックを探しおいる間、私はx,y,zを芋぀けるこずができたせんでした」ず蚀っおください。
  7. 誰かがあなたにハンドブックのリンクを送っおきた堎合、圌らは私たちが答えを文曞化したこずを誇りに思っおいたすが、あなたが自分で芋぀けるべきだったずか、これが完党な答えだずいう意味ではありたせん。
  8. 質問の答えが文曞化されおいない堎合は、すぐにマヌゞリク゚ストをしお、探した堎所にあるハンドブックに远加しおください。質問に答えおくれた人が、あなたが暡範ずなっお質問に答えおくれるのを芋るこずは、質問に答えおくれた人にずっおも嬉しいこずです。マヌゞリク゚ストは、助けおくれたこずぞの感謝の気持ちを䌝えるための最良の方法です。
  9. 䜕か (マヌゞリク゚スト、課題、コミット、りェブペヌゞ、コメントなど) に蚀及した堎合は、そのリンクを含めおください。
  10. すべおの䌚瀟のデヌタはデフォルトで共有可胜なものにしおください。ロヌカルのテキストファむルを䜿うのではなく、課題にコメントを残すようにしたしょう。
  11. 誰かが䜕かを尋ねおきたずきは、期限や自分がやったこずを返しおください。「will do」、「OK」、「it is on my todo list」などの回答は参考になりたせん。2分を費やしおもそのタスクを行う方が良いです。倧事なこずであれば、い぀やるかを考える必芁がありたすが、その情報を返すこずで、盞手は時間がかかりすぎるず別の方法で解決するこずになるかもしれたせん。
  12. CC ("cc @user") を䜿っお問題を誰かの泚意を匕くのは構いたせんが、誰かから具䜓的なアクションが必芁な堎合は、CCだけでは十分ではありたせん。蚀及されたナヌザは問題を読んでそれ以䞊の行動を取らないかもしれたせん。䜕かを必芁ずしおいる堎合は、誰から必芁ずしおいるのかを@ず䞀緒に明瀺的に䌝えおください。
  13. 内郚での議論のためにプラむベヌトなグルヌプを䜜るのは避けおください。
    1. 迷惑です(グルヌプ内のすべおのナヌザがメッセヌゞごずに通知されたす)。
    2. 怜玢できない。
    3. 共有できないグルヌプ内の人を远加する方法がないこれが耇数のグルヌプ䜜成に぀ながるこずが倚い。
    4. 誰もが参加者に基づいお各プラむベヌトグルヌプのトピックを芚えたり、内容を読むために再床グルヌプを開いたりしなければならない。
    5. グルヌプを離脱したり、90日を過ぎるず履歎が消えおしたいたす。
  14. チャンネルを䜜成しおも党く問題ありたせん。1回の顧客ミヌティングのためのチャンネルであっおも問題ありたせん。これらのチャンネルは「a_<顧客名>-内郚」ずいう名前にしお、「内郚」であるこずを瀺すべきです顧客ずは共有されたせん。
  15. **コミュニケヌションを明瀺的にするこずで、ロヌコンテクストのコミュニケヌションをしたしょう。**圓瀟は䞖界䞭に拠点を眮くリモヌト・オンリヌの䌚瀟です。混乱を避けるために、できるだけ倚くのコンテキストを提䟛したす。たた、コミュニケヌションの効率化のために、ナビキタスな蚀語を䜿甚したす。
  16. **抂念を議論する際には、仮説に傟倒しすぎないように泚意しおください。**仮説は䟡倀が䞋がり、党員の意思決定が統䞀されたものになるように建蚭的でなくなるずいう点がありたす。

3. CEOのReadMe, 取扱説明曞ペヌゞ

id Sijbrandijは、「DevOpsラむフサむクルのための単䞀アプリケヌションであり䞖界最倧のオヌルリモヌト䌁業であるGitLab」の共同蚭立者兌CEOです。
Sidのキャリアパスはトラディショナルなものではありたせんでした。圌は2007幎に初めおRubyのコヌドを芋お、それがずおも気に入ったので、独孊でプログラミングを孊びたした。圌が初めおGitLabに出䌚ったのはRubyプログラマヌ時代で、オヌプン゜ヌスぞの情熱をすぐに発芋したした。

2012幎にはGitLabの商甚化を支揎し、2015幎にはY-Combinatorの2015幎冬のバッチで䌚瀟を率いた。圌のリヌダヌシップの䞋、同瀟は過去6幎間で50倍の成長を遂げ、9人から66以䞊の囜ず地域にたたがる1,300人以䞊のリモヌトチヌムメンバヌにたで拡倧したした。

オヌプン゜ヌスコミュニティのチャンピオンであり、リモヌト組織をスケヌリングするパむオニアであるシドは、DevOpsの実践に関する埓来の垞識を倉え぀぀ありたす。

Sijbrandij 発音のヒント なども曞いおある。

4. リヌダヌシップ

  1. GitLabでは、個人のコントリビュヌタヌであれ、リヌダヌチヌムのメンバヌであれ、すべおの人にリヌダヌシップが求められたす。
  1. リヌダヌずしお、GitLabのチヌムメンバヌはあなたの行動に埓いたすので、垞に正しいこずを行いたしょう。
  2. GitLabに参加するすべおの人は、自分自身がGitLabの䟡倀芳のアンバサダヌであり、GitLabの文化を守る存圚であるず考えるべきです。
  3. **行動は瀟内倖で䞀貫したものでなければなりたせん。**䌚瀟の倖でも正しいこずをしたす。
  4. GitLabは、䜕があなたにずっお最善かずいうあなたの刀断を尊重したす。もし他の堎所にもっず良い機䌚があったずしたら、䌚瀟ぞの忠誠心からGitLabに留たる必芁はありたせん。
  5. 困難な時には、人はお互いのために最善の努力をするものです。
  6. 私たちは非同期にお仕事をしたす。暡範ずなるように指導し、起こったずきにはすぐに課題に曞き留めおおく必芁があるこずを理解させるようにしたす。
  7. 私たちは、民䞻䞻矩的な䌚瀟ではありたせんし、コンセンサスを重芖する䌚瀟でもありたせん。人々はコメントや意芋を述べるこずが奚励されおいたすが、最終的には、すべおのフィヌドバックを聞いた埌に䞀人の人間が問題を決定したす。
  8. 意芋の盞違や建蚭的な議論をするこずは奚励されおいたすが、知的な議論をしおください。
  9. 私たちは、結束力よりも真実を求めるこずを倧切にしたす。
  10. ミヌティングは、非同期のワヌクフロヌをサポヌトしおおらず、時差の関係で実斜が難しいため、可胜な限り避けたす。
  11. **時間通りにミヌティングを開始し、自分自身も時間通りに行動し、党員が出垭しおいるかどうかは尋ねないようにしたす。時間通りに来た人を埅ったり、遅れお来た人のために繰り返したりしお、時間通りに来た人をひどい目に遭わせるのはやめたしょう。**䌚議がプロセスや決定のブロックを解陀したずきは、それを祝うのではなく、こう尋ねたしょう。今埌、䌚議を必芁ずせずにブロックを解陀するにはどうすればいいのか
  12. 私たちはたくさんのフィヌドバックをしたす。改善のための提案をためらわないようにしたしょう。
  13. 倖郚の人に䌚った堎合、圌らが改善すべきだず思うこずは䜕かを垞に尋ねおください。
  14. ポヌル・グレアムのアドバむスを螏襲する。組織をよりシンプルにするように努力しなさい。
  15. **蚀葉の効果を期埅しお、「聞いたこずがあるでしょうが」、「井の䞭の蛙でないなら」、「誰でも知っおいるように」、「ご存知でしょうが」などず蚀うのは有毒です。**知っおいる人は蚀われなくおもいい。知らない人は䜕かを芋逃したように感じ、その背景を聞くのを恐れるかもしれたせん。
  16. 他人の名前を䜿ったり、自分の肩曞きを思い出させたり、あるいは物事を成し遂げるために「ランクを䞊げる」ようなこずはしないようにしたしょう。
  17. 目暙ず適切なタむムラむンを蚭定する責任を負うこずで、自分自身ず自分の圹割のCEOずしお行動したしょう。
  18. 目暙の状況に぀いお、チヌムや人のリヌダヌず明確にコミュニケヌションをずりたしょう。課題ずなっおいる分野に迅速に察凊したり、割り圓おられた時間枠内に達成できない目暙を再評䟡したりするために行動したしょう。

5. オフボヌディング

リストアップされた各ステヌクホルダヌは、それぞれのチヌムメンバヌの状況を取り巻く独自のニヌズずセンシティブさに合わせお、効率的で最善の方法でオフボヌディングが行われるようにするために重芁な圹割を果たしたす。

チヌムメンバヌの退職に䌎う自䞻的なオフボヌディングの堎合、ビゞネスパヌトナヌは、退職するチヌムメンバヌのマネヌゞャヌず共に、そのオフボヌディングが「遺憟」ずみなされるか「遺憟」ずみなされないかを怜蚎する必芁がありたす。

埌悔しないオフボヌディング

退職は、䌚瀟/顧客/プロゞェクト/チヌムぞの圱響を最小限に抑えるこずができたす。

オンボヌディングはもちろんなのだが、オフボヌディングに぀いお先に蚘茉されおいる点に共感。

6. Support Team Handbook

お客様を倧切にする

垞に自分が顧客の成功を保蚌する責任者であるず考えおください。
顧客をサポヌトしおいるずきは、問題や事故、損倱はすべおGitLabの損倱です。
顧客がトラブルやダりンタむムに芋舞われたずきは、GitLabがダりンタむムに芋舞われたずきず同じように、緊急性を持っお察応したしょう。
顧客が生産性を萜ずしおいるずきは、GitLabが生産性を萜ずしおいるずきず同じような緊急性を持っお行動したしょう。

経隓則ずしおは、2,500人のナヌザヌがダりンしおいる顧客に察しおは、GitLabが1日あたり1,000,000,000ドルの損倱を出しおいる堎合ず同じ緊急床で察応したす。この扱いは、圌らがいくら支払っおいるかに関係なく平等です。

早期に゚スカレヌトする CEOを含めたGitLab党䜓の可芖性を確保するには、埌回しにするよりも早めの方が良いでしょう。顧客のために必芁なすべおのリ゜ヌスを早期に投入するようにしたしょう。

サポヌトチヌムの䞀員である私たちは、誰かが問題や質問をしたずきに最初に察応する立堎であるこずを忘れないでください。そのため、䌚瀟を代衚しお、自分自身を適切に衚珟するこずが私たちの圹目です。そのため、私たちは以䞋のこずを求められおいたす。

垞に友奜的であり、敬意を払うこず。
新しいアむデアや芖点を受け入れおください。
分からないこずがあっおも平気です。い぀でも他の人に聞くこずができたす。
顧客にノヌず蚀っおも平気であるこずただし、回避策を提案し、必芁に応じおシニアに゚スカレヌションするようにしおください。

7. Our Product Principles

  1. 採甚は仕事。AプレむダヌがAプレむダヌを匕き寄せる PMの圹割が戊略的に重芁であるこずを考えるず、匷力なPMは巚倧なレバレッゞを生み出したす。私たちは、新しい人を採甚するたびに、チヌムの平均的なコンピテンシヌを䞊げるように努力すべきです。
  1. 個人に気を配り、盎接挑戊する。安心しお働ける瀟員ず、正盎にコヌチングするマネヌゞャヌがいるからこそ、人は最高の仕事をするこずができるのです。私たちは、タむムリヌで実行可胜なフィヌドバックを奚励しおいたす。たた、マネヌゞャヌは、リ゜ヌスだけでなく、感情や個人的な生掻を持った人間ずしおの瀟員を知るために時間をかけおいたす。
  2. **垞に孊び続けるこず。**スキル開発に継続的に投資し、個人ずしおもチヌムずしおも成長のマむンドを持぀こず。
  3. あなたはお客さんではありたせん。圌らず話をしたしょう。顧客を理解しおいるず思い蟌みたくなりたすが、しばしば間違っおいたす。私たちは、定性的および定量的な顧客からの入力を通じお、想定を怜蚌したす。
  4. 解決策ではなく、問題から始める。それは解決に右に飛び蟌みたくなるが、私達はしばしば根本的な問題に぀いお間違っおいる。よく圢䜜られた問題の声明は成功したプロゞェクトぞのキヌである。
  5. **冷酷に優先順䜍を぀ける。倚くのこずを䞋手にやるよりも、いく぀かのこずをうたくやる方がいい。**私たちはたず、自分たちが最も埗意ずするこず、そしお顧客が最も必芁ずしおいるこずに焊点を圓お、シンプルさを優先するべきです。顧客が必芁ずしおいるものが䞍足しおいる堎合は、顧客は教えおくれるでしょうが、䞍芁な機胜で顧客を圧倒しおいる堎合は教えおくれるこずはほずんどありたせん。
  6. **自分が間違っおいるず思い蟌む 人間の盎感は間違っおいるこずが倚い。**これず戊うためには、仮説を持っおいるすぐにそれを無効にしようずしたす。
  7. 反埩したす。すべおを前もっお蚈画しようずするのではなく、良い解決策に至るたでの道のりを反埩しおいくために、テンポの速いビルド・メゞャヌ・ラヌニング・フィヌドバック・ルヌプを掻甚しおください。
  8. **デヌタドリブンであるこず。**垞に成功の指暙を持ち、それらを远跡し、私たちの行動でそれらを正しい方向に動かすようにしおください。

たずめ

スケヌルする組織を支えるドキュメンテヌションの技術を”GitLab Handbook”から孊ぶ に戻るず、以䞋がフォヌカスされおいる。

1. Wikiではダメで、Gitリポゞトリじゃないずスケヌルできない

䌚瀟のハンドブックはWikiずしお始たるこずが倚くずっ぀きやすいが以䞋問題がある。

  • 時間の経過ずずもに叀くなる傟向がある。
  • ペヌゞの耇数の郚分や耇数のペヌゞにたたがるような提案をするこずができない。
  • 䜜業者ずレビュワヌの圹割を分けるこずができない。
  • 提案を取り蟌むべきか取りこたないべきかの議論もできない。

Gitリポゞトリを利甚するこずで、この問題は解決できる。

  • 提案がメンバヌの誰でもできるようになる。
  • 承認は該圓郚分を管理するマネヌゞャヌが意思決定できるようになる。
  • Pull Requestの䞭でオヌプンなディスカッションもできる。

䌚議の䞭でみんなが芋ながら内容を線集したい堎合などはGoogle Docsを甚いおいるようで、MTGが終わったら内容をMerge Request (GitHubでいうPull Requestにたずめお出すずいう圢で実斜しおいるようである。

2. ハンドブックファヌスト思想を貫く

GitLabではこのハンドブックファヌスト思想を貫いおいる。

  • ハンドブックは垞に最新であり、䞭に重耇がないように曞かれおいる。
  • さたざたな議論をSlackやメヌルや、むンタヌナルなプレれンテヌションを行う堎合に、該圓のハンドブックぞの参照URL぀けるこずを垞に詊みるこずが奚励されおいる。
  • わざわざ䜕かを説明する時にプレれンテヌションスラむドを䜜るのではなく、ハンドブックで代甚するこずが奚励される。

たずめのたずめ

ハンドブックは4000ペヌゞ匱あり、その党おを把握できおいる人はいない。しかしこのテキストの山を掻甚するためにGitLabでは怜玢機胜を぀けるこずを掚奚しおいる。冒頭にも曞かれおいるが、GitLabがそういう版管理補品を䜜っおいる䌚瀟だから培底できるずいう理由はある。Glassdoor でも批刀的意芋はあり、それは玍埗。

"If remote work doesn't agree with your mindset, this isn't the place for you"
"Working fully remote isn't for everyone" (in 10 reviews)

しかしリモヌトワヌクが䞭心になり぀぀ある我々も圌らず同様、考えお芋る䟡倀のある箇所がかなりありそう。ずいう意味で、以䞊自分のため含めたたずめでした。参考になればさいわいです。

//その埌調べた話 远蚘 : Slack瀟はSlackをどう䜿っおいるのか - Slack利甚ガむドラむンの話

//Organization
https://about.gitlab.com/company/team/structure/

684
611
2

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
684
611

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?