テキストマイニングを使って今年1年のレビュー内容をふりかえってみた話

テキストマイニングを使って今年1年のレビュー内容をふりかえってみた話サイボウズ株式会社ぴよ仲田尚央

自己紹介ぴよ（サイボウズ株式会社） _chick_p 今日話す人 🎤 お仕事サイボウズ製品の UI テキストを書く製品のヘルプページや開発者向けドキュメントを書く
仲田尚央（サイボウズ株式会社） naoh_nak ネタを考えた人 💭 お仕事サイボウズ製品の UI テキストを書く製品のヘルプページを書く他の言語に展開する（ローカライズ） 2

今日のおはなしテキストマイニングを使って、今年 1 年で自分が編集した記事へのレビューコメントを分析して、今年をふりかえってみたきっかけ 3

ヘルプサイトにおけるコンテンツの作成フローサイボウズでは、GitHub でヘルプサイトのコンテンツを管理している詳細：プロダクトのヘルプサイトをマークダウンに移行した話 | Cybozu Inside Out GitHub Reviewer
Pull Request コメント & 承認公開投稿 Writer Web 4

今年の Pull Request のレビューコメントを分析 Pull Request 今年⾃分が作ったレビューコメント
⼊⼒テキストマイニングツール Word Cloud 分析レビューに関するキーワード TextVoice ふりかえりの対象今年自分が編集したコンテンツに対する、メンバーからのレビューコメントの内容やったこと Pull Requestからレビューコメントを取得し、テキストマイニングツールでキーワードを分析 5

分析結果 6

分析結果 - ワードクラウドにしてみた（絞込前）レビューコメントにおけるキーワードの出現頻度から、ワードクラウドを作成画面文言や製品の機能名がノイズになったレビューに関するキーワードだけに絞り込むことにした 7

分析結果 - ワードクラウドにしてみた（絞込後）レビューに関するキーワードだけに絞り込んで、ワードクラウドを作成ライティングのテクニックに関するキーワードより、記載した内容に言及するキーワードが目立つ例：案内、カットなど 8

分析結果 - 実際のコメントを紹介係り受けがわかりにくいと、誤解しやすく翻訳もしづらい文になるユーザーがつまづきやすいポイントをフォローする想定読者にあわせて書きすぎない自社製品ではないブラウザやOSの設定は書かないコンテンツのメンテナンスコストも上がる 2022年は画像の代替テキストに注力していた
技術支援ツールを使ってヘルプを読むユーザーもいる 1 係り受けを明示して、どんなチェックボックスかを示した方が翻訳しやすそうかなと思いました。 2 この部分も、事前設定でできると勘違いしやすい部分だと思うので、「事前設定では、ユーザー追加はできないんだよ」と案内しておくと良さそうです。 3 Storeで2段階認証を設定する方は、その機能を理解している人だと思うので、L.9はカットしてもよいかなと思いました。 4 VerによってUIが変わったりするでしょうし、画像消しません？弊社以外のサービスはサポート外というのもありますし。 5 この補足のタイトルからどんなエラーメッセージが出るかは明確なので、Altでは簡潔に案内するので良さそうです。 9

まとめ（1/2）やったことテキストマイニングを使って、今年編集したコンテンツに対するレビュー内容をふりかえってみたふりかえってみて "テクニカルライティング"といえば、ライティングのテクニックが印象に残りやすいかも一文一義、係り受けなど実際のレビューは、記載する内容に言及することが多い何を書くべき／書かないべき読み手を意識した、内容の取捨選択
ヘルプページに書いてある = サポート対象になるアクセシビリティへの配慮（再掲）レビューコメントだけに絞込した後のワードクラウド 10

まとめ（2/2）来年にむけて読者を考慮して、書くべき／書かないべきの取捨選択をより意識する来年もふりかえってみて、ワードクラウドのキーワードの変化を確認したい 11

ご清聴ありがとうございました

おまけ：textlint のチェック結果ルール名エラー内容回数 jtf-style/4.3.7.山かっこ<> 半角になっている、かっこが閉じられていない 533 jtf-style/4.2.6.ハイフン(-) 半角になっている
158 jtf-style/4.3.5.二重引用符対になっている 115 jtf-style/2.1.2.漢字常用漢字じゃない 102 jtf-style/4.3.1.丸かっこ（）半角になっている、かっこが閉じられていない 34 ja-no-redundant-expression 冗長表現である 15 jtf-style/2.1.6.カタカナの長音長音記号がない 8 prh 表記ゆれがある 5 @textlint-rule/require-header-id 見出し ID が振られていない 4 jtf-style/2.1.5.カタカナ半角カタカナがある 3 jtf-style/4.2.4.中黒(・) 半角の中黒がある 3 jtf-style/4.3.3.かぎかっこ「」全角になっている 1 jtf-style/2.2.1.ひらがなと漢字の使い分けひらがなと漢字の使い分けが適切ではない 1 13

テキストマイニングを使って今年1年のレビュー内容をふりかえってみた話

テキストマイニングを使って今年1年のレビュー内容をふりかえってみた話

Cybozu
PRO

More Decks by Cybozu

Other Decks in Technology

Featured

Transcript