TechnicalWritingMeetup_20250821_SmartHR

2025年8月22日（金）Technical Writing Meetup vol.45 の発表資料です。
イベントページ：
https://tw-meetup.connpass.com/event/365605/

Transcript

1. © SmartHR, Inc. アジャイル開発の現場で、 UXライターに求められていること 近藤 美⾥ SmartHR UXライター 2025/08/21
2. 近藤 美⾥（SmartHR UXライター） ⾃⼰紹介 • 2023年4⽉に⼊社 • 前職は出版社で雑誌やWEBメディアの 編集の仕事をしていました • 転職の経緯はnoteにて🙌 ◦ わかりづらさに抗いたくて、編集者から SmartHRのUXライターに
3. 3 本⽇お話しすること • ☑ SmartHRのUXライターの仕事 • ☑ SmartHRにおけるUIテキスト検討の事例 • ☑ 改めて考えた「UXライターの役割」 こんな⼈に伝えたい！ • スピード感のある現場でUIテキストに携わる開発者 • UIテキストにフィードバックしたいマニュアル制作者
4. SmartHRの UXライターの仕事
5. SmartHRの「UXライター」 ⼀般的に、UXライターとは? • デジタル製品やサービスのUIにおけるテキスト を専⾨とするライターのこと • ⾔葉の⾯からユーザーの体験を サポートする役割を担う 5
6. SmartHRの「UXライター」 SmartHRとは？ • 労務管理クラウド7年連続シェアNo.1（※） の クラウド⼈事労務ソフト ◦ 企業の⼈事‧労務担当者と、従業員が使うソフトウェア ◦ 紙で⾏なわれていた⼈事‧労務の業務を効率化 ◦ 蓄まった⼈事データをタレントマネジメントに活⽤できる💪 • 「働くみんなが使いやすい」システムを⽬指しています 6 （※）※デロイト トーマツ ミック経済研究所「HRTechクラウド市場の実態と展望 2024年度版」労務管理クラウド市場‧出荷⾦額（2024年度⾒込） ttps://mic-r.co.jp/mr/03350/
7. SmartHRの「UXライター」 SmartHRの開発組織 • アジャイル開発 ◦ 開発サイクルを短期間に繰り返し、ユーザーからフィードバック を得ながら改善していくソフトウェア開発⼿法 • 合計35チームほどで構成 ◦ エンジニア、プロダクトマネージャー、 プロダクトデザイナー、QAエンジニア、 UXライターなどさまざまな職能が連携 ◦ UXライターは現在10名在籍 7
8. SmartHRの「UXライター」 SmartHRにおける「UXライター」 開発チームやプロダクトの状況に応じて、関わり⽅を柔軟 に変えながら、さまざまな形で貢献。 なぜなら… • アジャイルな開発で、開発アイテムが流動的なため • 会社の急成⻑に伴う開発チームの増加に対応するため • 開発チームの⼈数を絞り、コミュニケーションパスを抑 える⽬的も 8
9. SmartHRの「UXライター」 SmartHRにおける「UXライター」 プロダクトのUIテキストだけでなく、サポートコンテン ツも含めた広義の情報設計を担う。 • UIテキストの作成‧レビュー‧改善 • サポートコンテンツの作成‧レビュー‧改善 • ライティングガイドラインの作成‧管理 • ユビキタス⾔語の定義‧管理 • 開発チームへのスキル移譲 9
10. ここから本題
11. UXライターの「役割」は 何でしょうか？ 11
12. ユーザーにとってわかりやすい UIテキストを作成すること。 12 UXライターの「役割」は？
13. 13 UXライターの「役割」は？ ユーザーにとってわかりやすい UIテキストを作成すること。 →半分正解だけど、半分間違い  （SmartHRの場合） 
14. UIテキスト検討の事例を ご紹介します 14 成功例…ではありません🙏 また、少々難解なところがあります🙏
15. 事例 その1 なんと呼ぶべきか、難しすぎる設定項⽬ 15
16. UIテキスト検討の事例 その1 16 A社 B社 社員番号A-1001 管理 花⼦ 社員番号B-030 管理 花⼦ 同じ⼈物 企業アカウントグループ
17. UIテキスト検討の事例 その1 17 A社 B社 社員番号A-1001 管理 花⼦ 社員番号B-030 管理 花⼦ 同じ⼈物 企業アカウントグループ グループ全体を分析するとき、どちらのデータを参照する？
18. UIテキスト検討の事例 その1 18 ココ
19. UIテキスト検討の事例 その1 19 ココ 難しすぎません？？？
20. UIテキスト検討の事例 その1 • 当初の考え⽅ ◦ 拡張性を考慮（将来的には分析以外にも使われる可能性あり） ◦ 設定内容を⾔語化すると「SmartHRのさまざまなアプリをグルー プ単位で使うとき、どの企業アカウントがデータを提供するか」 ◦ そこで「各アプリへのデータ提供元」という案を考えた • しかし、スプリントレビュー等で 「わかりづらい」という反応が続出… 20
21. UIテキスト検討の事例 その1 改めて検討した結果 • 前提としていた「分析以外にも使われる」は、 だいぶ先になりそうと判明 • 拡張性も⼤事だが、YAGNI（必要となるまで 実装しない）の精神も⼤事 ◦ 将来破綻したら、そのときに改めて考えることに • 「分析対象」と命名 ◦ 当初の「各アプリへのデータ提供元」より ずっとわかりやすくなった 21
22. 事例 その2 正しく表現しようとしてドツボにハマる 22
23. UIテキスト検討の事例 その2 23 A社 B社 2025年健康診断 aさん ◎ bさん △ cさん ◯ 健診25春 dさん ◎ eさん ◎ fさん △ 健康診断 （2025年） aさん ◎ bさん △ cさん ◯ dさん ◎ eさん ◎ fさん △ この設定‧操作を なんと呼ぶか？ 企業アカウントグループ
24. UIテキスト検討の事例 その2 • 当初の考え⽅ ◦ いわゆる「マッピング」は難しい？ ▪ SmartHRは幅広い業種で使われており、ユーザーのなかにはIT⽤語やカ タカナ語になじみのない⼈もいる ◦ 「統合」だとデータそのものが統合されるように⾒えないか ◦ 表⽰するときに合体して⾒せるだけなので「カスタム項⽬の統合 表⽰」としてはどうか • しかし ◦ 統合後の項⽬は「統合表⽰項⽬」、それをつくる アクションは「統合表⽰項⽬の追加」…？と煩雑に 24
25. UIテキスト検討の事例 その2 25 A社 B社 2025年健康診断 aさん ◎ bさん △ cさん ◯ 健診25春 dさん ◎ eさん ◎ fさん △ 健康診断 （2025年） aさん ◎ bさん △ cさん ◯ dさん ◎ eさん ◎ fさん △ 企業アカウントグループ 統合表⽰項⽬？ 統合表⽰項⽬ の追加？
26. 改めて検討した結果… 26
27. UIテキスト検討の事例 その2 27 A社 B社 2025年健康診断 aさん ◎ bさん △ cさん ◯ 健診25春 dさん ◎ eさん ◎ fさん △ 健康診断 （2025年） aさん ◎ bさん △ cさん ◯ dさん ◎ eさん ◎ fさん △ 企業アカウントグループ 統合後の項⽬ 統合
28. UIテキスト検討の事例 その2 改めて検討した結果 • 「カスタム項⽬の統合」に決定 ◦ アクションを「統合」とすることで、「統合後のカスタム 項⽬」など、ユーザーがすでに馴染んでいる⾔葉のみで表 現することに成功 • ↑はUXライターではなくチームから出たアイデア ◦ 粘り強くみんなで考えた結果、 よい結論を出せた 28
29. 事例は以上です。 難しかったけど、わかりやすくなった！ めでたしめでたし！ 29
30. ……本当？👁 30
31. わかりやすくなったから、めでたしなのか？ 「わかりやすい」テキストを決めるのにかけた コスト • 議論する時間 ◦ 30分〜1時間のミーティング×数回 • 議論に関わった⼈ ◦ 約7⼈ • 実装や開発ドキュメントを修正する時間 31
32. わかりやすくなったから、めでたしなのか？ ⼀⽅で、「わかりやすさ」を享受できる⼈は… 32 機能 利⽤する⼈ 利⽤する⼈の数 企業アカウントグループ ごく一部の 人事担当者 （現時点では） 数百人 スマートフォンアプリ 「SmartHR」 すべての従業員 100万人以上！
33. 費⽤対効果、⾒合ってなくない？ 33
34. 関係者と話す。そして⾄った結論は… 34
35. 「⾼度な設定」だったのでは？ 35
36. 「⾼度な設定」でよかった説 「⾼度な設定」とは • 某ノーコード開発サービスの場合 ◦ 数値の表⽰についての細かな設定 ◦ デフォルトで有効な機能を無効化する設定 • 某ビジネスチャットサービスの場合 ◦ ファイルの保存期間や拡張⼦の設定 ◦ 外部連携の設定 • 某Wi-Fiルーターの場合 ◦ （初⼼者にはわからない通信のこまかな設定） 36
37. 「⾼度な設定」でよかった説 「⾼度な設定」の特徴 • ⼀部の⼈しか求めていない ◦ が、求めている⼈にとっては「待ってました！！」 • ときどきしか触らない ◦ ⼀度設定すれば、しばらくそのまま • 難しい ◦ ⾼度なので、それはそう 37
38. ……完全に当てはまっている😇 38
39. 「⾼度な設定」でよかった説 反省 • わかりやすくなったのはよかった • しかし費⽤対効果を考えると、元のわかり づらいテキストのままリリースしてもよ かった 39
40. とはいえ、 不安のあるままリリースなんて なかなかできない😢 40
41. この「不安」に向き合うことこそ UXライターの仕事なのかもしれない 41
42. 不安に向き合うことこそUXライターの仕事 なぜなら… • 開発チームはどうしても⽬の前の機能に⽬線が閉じがち • UXライターはさまざまなチームと関わるなかで、SmartHRを 総合的に⾒ている ◦ ほかの機能と⽐較した相対的な優先度に気づきやすい ◦ 既存の機能におけるユーザーのつまずきを把握している ◦ サポートコンテンツで補えるかどうかの判断もできる 42
43. 不安に向き合うことこそUXライターの仕事 なぜなら… • 開発チームはどうしても⽬の前の機能に⽬線が閉じがち • UXライターはさまざまなチームと関わるなかで、SmartHRを 総合的に⾒ている ◦ ほかの機能と⽐較した相対的な優先度に気づきやすい ◦ 既存の機能におけるユーザーのつまずきを把握している ◦ サポートコンテンツで補えるかどうかの判断もできる 43 →専⾨家であるUXライターが率先して「わかりづらいけど 今回はこれでいい」と判断することが⼤事
44. 専⾨家に 「⼤丈夫だよ！」と⾔ってもらえたら 開発チームも安⼼ 44
45. では改めて、 UXライターの「役割」は 何でしょうか？ 45
46. UXライターの役割とは UXライターの役割（SmartHRの場合） • 専⾨家ならではの視点で、UIテキストにかける コストの費⽤対効果を⾒極め、開発チームの 背中を押すこと • それにより、開発チームがユーザーに届ける価 値を最⼤化すること ◦ 💡価値には「わかりやすさ」だけなく「開発スピード」も含まれる 46
47. おわりに
48. おわりに こんなときに思い出してもらえるとうれしいです • わかりづらい！なんとかしよう！と思ったとき ◦ 本当に「なんとかする」必要があるのか、⾒極めましょう • わかりづらいUIテキストの改善を提案するとき ◦ 内容と合わせて、温度感を伝えることが⼤切。「絶対に直 すべき」「気になるが影響が⼤きくないので様⼦⾒でよ い」 ◦ 温度感を適切に判断し、明⽰できると、相⼿の安⼼‧信頼 につながるはず 48
49. おわりに 仲間を募集中です！ 49 https://open.talentio.com/r/1/c/smarthr/pages/111573
50. ご清聴ありがとうございました！ 50