技術記事を書く＆楽しむチームの作り方

Slide 1

Slide 1 text

技術記事を書く＆楽しむチームの作り方 Hatena Engineer Seminar #22 2022-10-26 id:onk 1

Slide 2

Slide 2 text

自己紹介 ● 大仲能史 a.k.a. id:onk ● 株式会社はてなチーフエンジニア ○ エンジニア組織のマネージャの一人 ○ アウトプット推進担当 2

Slide 3

Slide 3 text

3 今日の話

Slide 4

Slide 4 text

4 技術記事を書く＆楽しむチームの作り方

Slide 5

Slide 5 text

技術記事について、2つのテーマで ● 技術記事に対しての階段の存在 ● 他人の仕事を面白がれるコミュニティ作り 5

Slide 6

Slide 6 text

主にカジュアル面談で話した内容 6 https://jobs.qiita.com/employers/hatena-corp/dev_talks/255

Slide 7

Slide 7 text

7 ご応募お待ちしています

Slide 8

Slide 8 text

8 技術記事に対しての階段

Slide 9

Slide 9 text

よく聞く質問 ● 書いたら成長に効くとよく言われているのは知っている ● 書いてみたいと思っているが、こんな書き方をしてはいけない、と言われるのが怖い ● 良い記事を書くコツはあるか 9

Slide 10

Slide 10 text

技術記事は以下に類型化される 10 類型記事の目的・価値学習ノート筆者による理解の復習・確認やアウトプットの練習のために書かれる。教科書読者に対する知識の提供を主な価値とする。論文単なる知識だけでなく、アイデアや技術の新規性を提供する。 https://zenn.dev/uhyo/articles/technical-articles

Slide 11

Slide 11 text

コミュニティに正の価値を与えるのは難しい 11 https://speakerdeck.com/line_developers/writing-technical-articles-as-you-like

Slide 12

Slide 12 text

他人と同じ内容の記事にも価値がある 12 https://naomichi-h.hatenablog.com/entry/2021/07/13/152908

Slide 13

Slide 13 text

きっと、まったく同じ内容にはならない 13 https://lacolaco.hatenablog.com/entry/2021/03/08/100228

Slide 14

Slide 14 text

14 という前提の上で、付け足せることがあるとしたら

Slide 15

Slide 15 text

作業メモを書きましょう ● 「こうなると思ったのに違った」を探す ● 作業メモに以下を書き残す ○ ○○したいので○○する (e.g. 検索、コマンド実行) ○ 何が起きると考えているか ○ 実行してみたらどんな結果が得られたか ○ 得られた結果は、実行前に考えたものと比べてどうか 15

Slide 16

Slide 16 text

作業メモを書きましょう ● OSS Gateのプラクティス ○ どんな粒度で書いていくのかの動画もある 16

Slide 17

Slide 17 text

作業メモを書きましょう ● この章は最高なので読んで欲しい ○ https://github.com/oss-gate/ﬁrst-feedback-gui debook/blob/master/chapters/what.md 17

Slide 18

Slide 18 text

18 https://github.com/oss-gate/ﬁrst-feedback-guidebook/blob/master/chapters/what.md

Slide 19

Slide 19 text

つまずきに敏感でいる ● 作業メモを残すと、メモの中につまずきが書き残されていく ○ OSS Gateの場合、メモの隙間にも注目できるようにサポーターを配置している ● 慣れてくるとメモを簡略化してもつまずきに気づけるようになる 19

Slide 20

Slide 20 text

20 前半のまとめ

Slide 21

Slide 21 text

前半のまとめ ● 技術記事は以下に類型化される ○ 学習ノート、教科書、論文 ● 最初はコミュニティに正の価値を提供せず、学習ノートで良い ○ 学習ノートにも良い学習ノートはある ● 正の価値を提供するには気づきが必要 ● つまずきに敏感でいるために作業メモを書く 21

Slide 22

Slide 22 text

作業メモとWorking Out Loud ● WOLはチーム開発を円滑に進めるテクニック 22 https://blog.studysapuri.jp/entry/2018/11/14/working-out-loud

Slide 23

Slide 23 text

23 他人の仕事を面白がれるコミュニティ作り

Slide 24

Slide 24 text

よく聞く質問 ● 「いるだけで成長できる環境(※) 」を作りたい ○ 技術の話題で盛り上がれるコミュニティ ● 社内から技術記事が湧いてくるようにしたい 24 https://tech.pepabo.com/2015/11/17/pepabo-tech-blog-has-started/

Slide 25

Slide 25 text

話題が出ない →出る、に変えるには ● 場を作る ● 面白がりの信頼 25

Slide 26

Slide 26 text

場を作る ● 非同期よりも同期コミュニケーション ○ 例えば、Slackに気になった技術記事のURLを投げたら自然と会話が発生するかというと、そうでもない ○ はてな社内でも、#engineer なら何かしら発生するが #ruby は会話が生まれづらい、とかがある ○ 昼会で話題に出すと、URLだけよりも圧倒的に会話が発生しやすい 26

Slide 27

Slide 27 text

場を作る ● 昼会に1h使っているチームもある 27 https://www.slideshare.net/takafumionaka/ss-251487630

Slide 28

Slide 28 text

場を作る ● 仲間を作る ○ 例えば、いきなりesaやQiita Team等を導入しても、まず上手くいかない ○ 普段から会話がある中で、ストックとして書き残そうという動きとして発生するのが望ましい ○ SaaSを使うのではなく「wikiを作る」をすると、一緒に作った人は愛着もサンクコストもあるので、複数人が投稿する場になるかも？ 28

Slide 29

Slide 29 text

場を作る ● ヒーローインタビュー ○ 誰がどんな仕事をしていたかを把握した上で、各仕事の興味深いところを紹介して、一言コメントを求める、という辺りから始めると良い ○ 自分から「こんな仕事があって〜」は出てこなくても、水を向けられたら、楽しかったところ、難しかったところのコメントは出てくる 29

Slide 30

Slide 30 text

場を作る ● ヒーローインタビューの準備をするのは大変 ○ 足を使って情報を集める必要がある ○ 各プロジェクトのふりかえりから抽出する ■ コメントにしやすい教訓が生まれているので、話題を振ると教訓が出てくる ○ 1on1を上手く使うと勝手に集まってくる ■ 最近やったことを聞く中で「これをコメントして貰うと盛り上がりそう」が分かる 30

Slide 31

Slide 31 text

面白がりの信頼関係 ● 1on1を基点にするのはオススメ ○ 誰がどんな技術を使っているのかを、少なくとも自分が知っている状態を作れる ○ 誰がどんな技術に興味があるのかを、少なくとも自分が知っている状態を作れる 31

Slide 32

Slide 32 text

面白がりの信頼関係 ● 1on1を基点にするのはオススメ ○ その話題を面白がる相手が少なくとも自分1人はいるぞというのを伝えられる ○ 「面白がって貰える安心感」を渡す ■ 成功体験になるので、ヒーローインタビュー時にも、出して欲しいコメントが出てくる 32

Slide 33

Slide 33 text

面白がりの信頼関係 ● 面白がって貰える自信・信頼を構築すると、場を用意するだけで書いて貰えるようになる ○ 各チームの大小様々なやっていることを共有する会をやったら予想外に盛り上がった話 - Sexually Knowing ○ 「他チームの人が面白いことをやっていること」に興味を持つ状態を前段で作っておくと上手く回る 33

Slide 34

Slide 34 text

面白がりの信頼関係 ● 色んな粒度のコミュニティを用意する ○ チームの昼会 ■ チームで使っている技術の話題は興味を持って貰いやすい ○ 技術勉強会 ■ 人数が多い、誰かに伝わる、知らないことを知るのは楽しい ○ サブ会 ■ 特定技術に興味がある人が集まっているので、そもそも興味がある 34

Slide 35

Slide 35 text

35 　後半のまとめ

Slide 36

Slide 36 text

後半のまとめ ● 話題が出ない→出るに変えるには ○ この人なら絶対この話題に食いつくだろう、という信頼感を醸成していく ■ 同期コミュニケーションで反応を引き出すことで、食いつきの確信を得ていく ■ 同じ興味を持つ人を入れるハコを作る 36

Slide 37

Slide 37 text

37 技術記事を書く＆楽しむチームの作り方

Slide 38

Slide 38 text

ご応募お待ちしています 38 https://jobs.qiita.com/employers/hatena-corp/dev_talks/255