テレワークで始めたドキュメント駆動業務｜Dentsu Digital Tech Blog

こんにちは。電通デジタルでEMをしている河内です。エンジニアにおける採用・評価、スクラムマスターなどを担当しています。今回はすこし実装プラクティスから離れた話題になりますがお付き合いくださいませ。 弊社もご多分に漏れず完全テレワークを実施しており、かれこれ4か月が経ちます。その中で見えてきた課題とエンジニアチームとしてどう対峙したか、そしてそこで得た気づきを綴っていきたいと思います。この内容は、過去に開催したオンラインイベントでお話した内容になります。 テレワーク環境で私たちのエンジニア部門で急務と感じた課題テレワークが開始された2月後半、プログラミングやシステム開発プロジェクトを生業とする私たちの部では「リモート？全然OK。支障無いっす。」とタカを括っておりました。しかし開始されて間もなく、やっぱり慣れていない事が判明・・・。テレワークを経験されている読者の多くの方が感じていることと同様

[morimarii]

ドキュメントは作るのは簡単だけどメンテナンスが大変で、メンテナンスしないとただゴミを作っただけで終わるからなあ

[hyperash]

これはある“エンジニアはSlackやメールを使った非同期コミュニケーションに慣れていると思っていました。しかし、実際は思いっきり口頭伝承、対面会議といった同期型コミュニケーションに大きく依存していました”

[ducktoon]

こんなのは「はぁ？ 読んでないの？」「あ、それ古いんで実際はこうだぞ」「更新してる暇ないんで(自分だけが情報を握っていたい)」みたいにしかならん

[takilog]

一度目しか使われないクソドキュメントたちも思い出してあげてください

[sendai]

あれだけ騒がれてるのに電通系列に所属してますと公言できる厚顔無恥さが電通たる所以なのか。

[tpircs]

1か月くらい前に社内向けに『after covid における多様性を活かすためのコミュニケーション作法変革 - 文書指向スタイル（DocumentOrientedStyle)』って読み物を書いた（自分語り）

[showii]

祭りはもうないんですか？

[deztecjp]

アメリカがドキュメント整備に真剣なのは、従業員がすぐ辞める／解雇されるので、口伝では破綻するため。基本、口伝で済むならその方が、結局はラク。日本でドキュメントの更新が続かず、読まれもしないのは自然。

[lacucaracha]

まず設計書を作ります。

[yuuki5555]

“企画書”

[kai_kou]

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

[diveintounlimit]

上っ面のふわっとしたとこしか書いてないな。

[zetta1985]

ドキュメントの読者があらゆるドキュメントの変更権限を有する（そしてそれを推奨する文化がある）、というのがポイント。これがないとドキュメントが更新されずに埋没していく

[su_zu_ki_1010]

"業務を行う前にハンドブックを見る。書いてなければ、新たにハンドブックを書く。その次に業務を行う" これって大事なことだよね。まずドキュメントを読んでやること、手順など確認しましょう。

[udonj]

ドキュメンテーション

[maruhoi1]

作業方法ではなく「なぜその作業をするのか」みたいな部分のドキュメント化が大切だと思っている

[yarumato]

“主業務以外の業務（技術共有、チームの知識共有）が思った以上に死角になる。出会ったGitLabハンドブック。業務遂行文書をgit管理、全員が編集権限、変更理由や議論を全て記録、テスト駆動開発を業務に取りこむ”

[northlight]

"ドキュメント読む駆動"はほんとそれ感が強い。

[tettekete37564]

テストを保守する重要さを知っている組織なら問題無いんだろうな。

[lyiase]

他のブコメでも言われているようにメンテが絶対死ぬ。それを殺さないようにするには『マサカリを投げつける行為は厳禁』は良くない戦略だと思う。見ないと怒られる→見られる→直すモチベが湧くだと思うので

[akahigeg]

ドキュメントのメンテは大変かもだがやる価値はある

[saikyo_tongaricorn]

何してるんだろ

[yood]

ドキュメントを人にインプットする方法が、読むという時間単位の量が限られ解釈のゆらぎの発生する方法しかないのがね。電脳化するか超賢いAIアシスタントがいる。

[zoidstown]

“エンジニアはSlackやメールを使った非同期コミュニケーションに慣れていると思っていました。しかし、実際は思いっきり口頭伝承、対面会議といった同期型コミュニケーションに大きく依存していました。”

[ten-gallon-Mouse]

“主業務以外の個々人の上記のようなメタ情報というのは意識的に流通させないと認知しづらいという性質がありました。この「個人メタ情報」の流通、認知が無ければ個々の成長、チームの成長も鈍化し同じ組織で働く意

[convivial]

いずれこれをやらねば

[asahiko]

あした読みたい

[asa_ca3]

“Pull Request上での仕様策定のディスカッションに慣れていないという事でもありました・・・” わかりみ

[kanda_k]

テレワークをきっかけに社内ドキュメントを整備したよという話