テクニカルライターのチームで「目標」をどう決めたか / MVV for a Team of Technical Writers

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

© LY Corporation Yoshiko Horikoshi 6 プログラマ（3年）広報（4年）インフラエンジニア（7年） 2020年1月からLINEでテクニカルライター 2023年10月からLINEヤフー Programmer (3 years) Public Relations (4 years) Infrastructure Engineer (7 years) Technical Writer at LINE since January 2020 From October 2023 at LY Corporation @mochikoAsTech

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

Slide 39

Slide 39 text

Slide 40

Slide 40 text

Slide 41

Slide 41 text

Slide 42

Slide 42 text

Slide 43

Slide 43 text

Slide 44

Slide 44 text

Slide 45

Slide 45 text

Slide 46

Slide 46 text

Slide 47

Slide 47 text

Slide 48

Slide 48 text

Slide 49

Slide 49 text

Slide 50

Slide 50 text

Slide 51

Slide 51 text

Slide 52

Slide 52 text

Slide 53

Slide 53 text

Slide 54

Slide 54 text

Slide 55

Slide 55 text

Slide 56

Slide 56 text

Slide 57

Slide 57 text

Slide 58

Slide 58 text

Slide 59

Slide 59 text

© LY Corporation 独自解釈で定義したMVV ミッションとはミッションは「使命」です。子供たちが大好きなアンパンマンでいうところの「何のために生まれて〜」というアレです。たとえばウルトラマンなら「この星の人たちを守る！」みたいなものがミッションですね。ビジョンとはビジョンは使命を果たすために自分たちはこういう存在、組織になりたいという「理想像」です。ここで大事なのは、チーム内の個々人ではなく「組織」の理想像であるということです。ウルトラマンなら「みんなのヒーロー」みたいなものですね。ちなみにいろいろなMVVを調べたところ、企業によってこのビジョンは省略されることもあるようです。バリューとは最後にバリューは、理想とする存在になり、使命を果たすための「行動指針」です。たとえば大胆さと慎重さ、素早さと確実さのように相反するものの間で、自分たちが何を優先して行動すべきか迷ったときの指針になるものがバリューです。ウルトラマンなら、仮に「誰も死なせない」というバリューがあれば、「目の前の敵にとどめを刺せば、もう二度と地球は襲われず平穏が訪れる。でも敵を倒すことを優先したら、隣にいる瀕死（ひんし）の地球人は治療が間に合わずに死んでしまう」みたいなときに、バリューに従って「敵を倒すより、地球人を病院に連れていこう」という判断ができます。 59

Slide 60

Slide 60 text

© LY Corporation 自社のMとVを独自解釈で確認ミッションとはミッションは「使命」です。子供たちが大好きなアンパンマンでいうところの「何のために生まれて〜」というアレです。たとえばウルトラマンなら「この星の人たちを守る！」みたいなものがミッションですね。ビジョンとはビジョンは使命を果たすために自分たちはこういう存在、組織になりたいという「理想像」です。ここで大事なのは、チーム内の個々人ではなく「組織」の理想像であるということです。ウルトラマンなら「みんなのヒーロー」みたいなものですね。ちなみにいろいろなMVVを調べたところ、企業によってこのビジョンは省略されることもあるようです。バリューとは最後にバリューは、理想とする存在になり、使命を果たすための「行動指針」です。たとえば大胆さと慎重さ、素早さと確実さのように相反するものの間で、自分たちが何を優先して行動すべきか迷ったときの指針になるものがバリューです。ウルトラマンなら、仮に「誰も死なせない」というバリューがあれば、「目の前の敵にとどめを刺せば、もう二度と地球は襲われず平穏が訪れる。でも敵を倒すことを優先したら、隣にいる瀕死（ひんし）の地球人は治療が間に合わずに死んでしまう」みたいなときに、バリューに従って「敵を倒すより、地球人を病院に連れていこう」という判断ができます。 60

Slide 61

Slide 61 text

Slide 62

Slide 62 text

Slide 63

Slide 63 text

Slide 64

Slide 64 text

Slide 65

Slide 65 text

Slide 66

Slide 66 text

Slide 67

Slide 67 text

Slide 68

Slide 68 text

Slide 69

Slide 69 text

© LY Corporation ミッション役に立つドキュメントで開発をもっと楽しく（Make development fun with helpful docs）開発者がLINEヤフーの提供するプロダクトを使って開発をするとき、その体験が楽しいものになるか、それともイライラしたつらいものになるかには、プロダクトそのものの使いやすさだけでなく、ドキュメントの分かりやすさも大きく関わってきます。私たちDev Contentチームの「使命」は、分かりやすく役に立つドキュメントで、みんなの開発をもっと楽しくしていくことです。 69

Slide 70

Slide 70 text

© LY Corporation ビジョンドキュメントのスタンダードを確立するパイオニア（Be the pioneer. Set the standard for IT technical documentation.） LINEヤフーの社内でも、あるいは周りのIT企業を見渡しても、ドキュメントで悩んでいるところは多くあります。たとえば「ちゃんとドキュメントを残すべきだ」という気持ちがあっても、どうしても開発だけが先行してドキュメントは置いてけぼりになってしまう。あるいはみんな頑張って社内に情報を書き残しているけれど、あまりにコンテンツが多すぎて「もう古くなってしまった過去の仕様」と「最新の仕様」がごちゃごちゃになって見つけられない、といった事象にはみなさんも心当たりがあると思います。テクニカルライターのチームを抱える会社は少しずつ増えてきたものの、まだ当たり前の存在にはなっていません。私たちは、「ドキュメントってああいうふうに書いたり、管理したりすればいいんだ。うちもLINEヤフーのやり方をまねしてみよう！」と言われるような、ドキュメント管理のスタンダードを確立するパイオニアになることを「理想像」として掲げました。 70

Slide 71

Slide 71 text

Slide 72

Slide 72 text

© LY Corporation バリュー走りながら考える（Think on the run）何かをやるかやらないか、どんなふうにやるか、という計画を立てることは大切ですが、検討に時間をかけすぎていつまでもその場にとどまっていると何も始まりません。何かやった方がいいと思うことがあったら、取りあえずやってみよう！まずは走り出して、それ以上のことは走りながら考えよう！やってみて失敗しても、少なくとも「こうやったらうまくいかない」という学びが得られるという点でなにもやらないよりはいいことだ、と私たちは思っています。 72

Slide 73

Slide 73 text

© LY Corporation バリュー早く公開すれば早く直せる（Release early, fix faster）情報の正確さは大切ですが、一方で「完璧で何一つ誤りのないドキュメントになるまでは世に出さない」と思っているといつまでもドキュメントが公開できません。ドキュメントが何もない状態よりは、多少の不足や分かりにくさがあってもドキュメントが「ある」方がまだいいはずです。万全を期すあまりにいつまでもリリースできないよりは、ある程度の失敗を許容することで早く公開することを優先しています。 73

Slide 74

Slide 74 text

© LY Corporation バリュー惜しみなく出すともっと得られる（The more we share openly, the more we gain）テクニカルライターが持つライティングの知見は、社内の研修や社外のイベントなどで惜しまず共有しています。自分たちが書くものだけでなく自社全体のドキュメントが、さらに自社だけでなく業界全体のドキュメントの品質が底上げされていく過程に貢献できたら、それは素晴らしいことです。ノウハウは隠して独占するよりも、みんなで広く共有し、集合知によってさらに改善されていった方がいいはずです。 74

Slide 75

Slide 75 text

© LY Corporation バリュー愛着が湧くほど詳しくなろう（Know the product best, love the product most）そのプロダクトに興味のない人間がおざなりな理解で書いたドキュメントは、読めばそれと分かるものです。私たちは「言われたとおりにドキュメントを書くだけ」ではなく、実際の開発者と同じようにそのプロダクトを使ってみて、仕様や背景を理解した上で、分かりやすいドキュメントを作り上げたいと思っています。そのためにはプロダクトに愛情を持つことで詳しくなり、詳しくなることでもっと好きになっていく、という姿勢が不可欠です。 75

Slide 76

Slide 76 text

Slide 77

Slide 77 text

Slide 78

Slide 78 text

Slide 79

Slide 79 text

Slide 80

Slide 80 text

Slide 81

Slide 81 text

Slide 82

Slide 82 text

Slide 83

Slide 83 text

© LY Corporation 83 バリュー惜しみなく出すともっと得られる（The more we share openly, the more we gain）テクニカルライターが持つライティングの知見は、社内の研修や社外のイベントなどで惜しまず共有しています。自分たちが書くものだけでなく自社全体のドキュメントが、さらに自社だけでなく業界全体のドキュメントの品質が底上げされていく過程に貢献できたら、それは素晴らしいことです。ノウハウは隠して独占するよりも、みんなで広く共有し、集合知によってさらに改善されていった方がいいはずです。

Slide 84

Slide 84 text

Slide 85

Slide 85 text