
2025.02.12
職員一人あたり52時間の残業削減に成功 kintone導入がもたらした富士吉田市の自治体DX“変革”ハウツー
リンクをコピー
記事をブックマーク
岩瀬義昌氏:最後にもう1個だけ。今日は9章までしゃべりたかったので、これをあと5分でしゃべれればゴールですね。ドキュメントの品質測定について話していきます。
(スライドを示して)品質測定、このあたりのキーワードから、きっとエンジニアであれば1度は言われたことがあるんじゃないかという言葉はこれです。
「計測できないものは改善できない」という言葉があります。これはいろいろな引用元があるので(スライドの)後ろに画像を出していますが、計測したいんですよね。というのも、これができていないと行き当たりばったりでプロダクト改善をすることになるので、基本的には何らかの指標で計測をしたいと思います。そのために「そもそもどうやればいいんだろう」「どう計測すればいいんだろう」と考え始めるわけです。
いったん1回だけ立ち戻って考えてほしくて。計測するんだったら何が優れているかを決めていないといけないので、まずは優れたドキュメントというものを定義してからその先に進んでいきます。「優れたドキュメントとは何か」をGoogleのエンジニアたちが言っている言葉があって、これをそのまま引用して本書では使われています。
「ドキュメントが優れているのは目的にかなっている場合である」と言い切っているわけです。これは有名な定義の1つです。
この目的は何かというと実は2つあって、1つがドキュメント自体でユーザーの特定の行動を促進する、推進することです。2つ目が組織のゴールです。これはプロダクトのゴールと言い換えてもいいですね。組織のゴールを達成すること。この2つを満たしているものが良いドキュメントなわけです。
この目的をさらにブレイクダウンして考えやすくしていくと次のようになります。ゴールを達成する品質をさらに考えていくわけですね。品質は大きく2つあって、この目的を達成するための品質で重要なのは、先ほど言いましたが1個目は機能品質で、ドキュメントの目的はゴールが達成されているかということです。
今日、しゃべり始めてからずっと「ユーザーの課題は何だ」とか「それは誰の何を解決するんだ」ということを言い続けているんですよ。まさにこれも一緒で、一番測るべきは「ドキュメントの目的はゴールが達成されているか」、言い換えると「ユーザーの価値になっているか」ということになると思います。これが1個目です。
もう1つが構造品質で、ドキュメントそのものにも品質がありますよね。「うまく書けていますか?」と。例えば「てにをは」や、あとはパラグラフの分け方がうまく構成されているかが構造品質になっていきます。
(スライドを示して)それぞれの品質の中身をめちゃくちゃしゃべりたいんですが、時間的に無理なことがわかってきたのでここに羅列していきます。左側が機能品質、右側が構造品質です。左側のほうが先ほど言ったとおりのゴールに近づくやつで、右側が例えば明確・簡潔・一貫性など、文章を書く時に気をつけることですね。
2つの品質を紹介しましたが、重要なのはどちらが(より)重要かというところなんですよ。もうみなさんは答えをわかっていると思います。2つあるんだったら、圧倒的に機能品質(が重要)です。
何度も言っているんですが、どれだけすばらしい文章があったとしても、どれだけ最高のパラグラフ構成だったとしても、ユーザーのゴールの達成につながらなければそのドキュメントは価値がないので、徹底的に機能品質を考えるのが重要かなと思います。なのでそれを意識してドキュメントを書いて、リリースサイクルを回していくのがいいかなと思います。
おまけでもうちょっとだけ。品質特性はいろいろなパターンがあるので、他にもあります。例えばドキュメントのメトリクスはすぐに取れるんですよね。特にWebのドキュメントに関してはGoogleアナリティクスなど、いろいろな解析ツールがあるので、PV数やユニークユーザー数や直帰率とか。
あとはTTHW(Time to Hello World)ですね。これはプログラミング言語を使う時に、(その言語が)「Hello World」を出すのにどれだけ時間がかかるかというのを測る時間の指標です。APIであれば最初の一番シンプルなGETを叩くまでとか、そんな感じです。
という感じでメトリクスはたくさんあるので取れるんです。これももちろん品質改善に使えます。ただ、めちゃくちゃ(種類が)あるので「どれを使ったらいいですか?」ということを絞り込んでいくほうがどちらかというと重要です。
たくさん取れるけど、絞り込んで本当に重要なものを使うのであればだいたい活用の計画を立てておくと良くて。「なんでそのメトリクスって重要なんですか?」「さらにその情報を使ったら何ができますか?」「それを使うと組織のゴールはどんなふうに前に進みますか?」という、メトリクスに関しても前段階を考えておくと、より良く効果的に使えるかなと思います。
(スライドを示して)こんな感じで、集め始めるとベースラインが取れます。つまり現状が50点なので、何かしたら次は60点になるというかたちにわかるようになります。メトリクスがあることによって比較ができるようになりますよね。改善が効くというか、論理的にわかるようになるのは、このあたりのパート(の効果)になっているかなと思います。
ということで、時間があったら日本語特有の観点(を紹介する)というところで一瞬だけ紹介します。
冒頭で左下の『理科系の作文技術』(という本など)を紹介したんですが、ドキュメントの本はたくさんあるので、いろいろな本を参照するとどんどんうまくなります。
(スライドを示して)時間がないので(詳しく)紹介はしないんですが1個だけ。ちょっと割愛しますね。僕はこれがけっこう気になる病にかかっているので、最後に1個だけ紹介して終わります。
日本語のテクニカル系の硬い文章を読んでいくと、動詞に「方法」とか「こと」というのを付けて、安易に名詞化しているケースがよくあります。これをやるとけっこう冗長でくどい日本語になります。
わかりづらいのでわかりやすい例を出すと、「機能Aを使用するという方法もあります」みたいな。こうやって書いても良いと言えば良いんですが、これは「機能Aも使用できます」と(すれば)めちゃくちゃシンプルに書けます。
他にも「Bにより改善することができます」。「する“こと”」って付いていますよね。これはいらなくて、「Bにより改善できます」で十分に意味は伝わるので、これを気をつけていくだけで、シンプルで見栄えの良い文章(になり)、しかも読みやすくなるので、このあたりを気をつけておくと良いかなと思って紹介を終えたいと思います。
(スライドを示して)ということで今日はめちゃくちゃしゃべったんですが、(全体として)こんな感じの概要を今日はしゃべってきました。
書籍の概要をしゃべって、1章で一番重要な(ことは)ドキュメントを書く上では読み手の理解が大事。3章で(重要なこととして)「書く上ではこういうことを考えましょう」というところを伝えてきました。
フィードバックの集め方に関してはこんな方法があって、トリアージする方法がありますねと。あとは「品質って何がありましたっけ?」というところで、機能品質と構造品質。どれだけきれいに書けていても、ゴールが達成されていないと意味がないとか。あとはおまけはしゃべっていませんが、良書がいっぱいあるので見てくださいというところが今日話した内容でした。
ゴールをおさらいしておくと、最初の2分ぐらい(のところ)で、「今日のイベント終了時、30分後にはこんな状態になっていたらいいですね」ということを話しました。
(スライドを示して)上のところが本書の今日のメインのゴールで、ちょっとでもスキルが、(ドキュメントライティングに対する)解像度が高まった気分になっていれば良いかなと思うので、ぜひ実践につなげてもらえればと思います。
今日はしゃべれていない内容が正直いっぱいあって。先ほど言った「良いサンプルコードって何だろう」とかはまったくしゃべっていないので、さらに詳細が知りたい場合は、興味を持っ(てもらえ)たら、本には全部書いてあるので、本を買ってもらえたら僕はうれしいかなと思って、私の講演パートは終わりにしたいと思います。
ということで今日のお話は以上です。ありがとうございました。
関連タグ:
2025.02.13
“最近の新人は報連相をしない”という、管理職の他責思考 部下に対する「NG指示」から見る、認識のズレを防ぐコツ
2025.02.06
すかいらーく創業者が、社長を辞めて75歳で再起業したわけ “あえて長居させるコーヒー店”の経営に込めるこだわり
2025.02.13
AIを使いこなせない人が直面する本当の課題 元マッキンゼー・赤羽雄二氏が“英語の情報”を追い続ける理由
2025.02.12
マネージャーは「プレイング3割」が適切 チームの業績を上げるためのマネジメントと業務の比率
2025.02.12
何度言っても変わらない人への指示のポイント 相手が主体的に動き出す“お願い”の仕方
2025.02.13
「みんなで決めたから」を言い訳にして仲良しクラブで終わる組織 インパクトも多様性も両立させるソース原理
2025.01.07
1月から始めたい「日記」を書く習慣 ビジネスパーソンにおすすめな3つの理由
2025.02.10
32歳で「すかいらーく」を創業、75歳で「高倉町珈琲」で再起業 「失敗したからすかいらーくができた」横川竟氏流の経営哲学
2025.02.14
報連相ができない部下に対するコミュニケーションの取り方 「部下が悪い」で終わらせない、管理職のスキル向上のポイント
2025.02.10
A4用紙を持ち歩いて殴り書きでアウトプット コクヨのワークスタイルコンサルタントが語る、2種類のメモ術
着想から2か月でローンチ!爆速で新規事業を立ち上げる方法
2025.01.21 - 2025.01.21
新人の報連相スキルはマネージメントで引きあげろ!~管理職の「他責思考」を排除~
2025.01.29 - 2025.01.29
【手放すTALK LIVE#45】人と組織のポテンシャルが継承されるソース原理 ~人と組織のポテンシャルが花開く「ソース原理」とは~
2024.12.09 - 2024.12.09
『これで採用はうまくいく』著者が語る、今こそ採用担当に届けたい「口説く」力のすべて
2024.11.29 - 2024.11.29
【著者来館】『成果を上げるプレイングマネジャーは「これ」をやらない』出版記念イベント!
2025.01.10 - 2025.01.10