Product-Writing

© 2024 Aguri Otsuka All Rights Reserved. 今日話すこと・プログラムとテキストの違い
・業務アプリケーションとメンタルモデルの関係・大切なのは視座の切り替え・命名・分類・構造化・プロダクトライティングの技術

© 2024 Aguri Otsuka All Rights Reserved. して欲しい動作〇〇してほしい
コード処理動く〇〇する

© 2024 Aguri Otsuka All Rights Reserved. 〇〇してほしい伝えたいこと
テキストふむふむ処理〇〇しよう！伝わる

© 2024 Aguri Otsuka All Rights Reserved. 伝えたいこと〇〇してほしい
テキストふむふむ処理 ▲▲ したくなった！伝わらない

© 2024 Aguri Otsuka All Rights Reserved. 残念ながら読まれない場合もある… 出典：「論理が伝わる　世界標準の「書く技術」」倉島保美　読み手は、まず、その文章を読み進むべきか、
読むとすればどの程度の優先度なのかを判断します。読み手は、手にした文章のすべてを、手にした順に読んでいくわけではありません。詳細まで読まなければならない文章もある一方、概略だけで十分と思う文章もたくさんあります。今すぐ読むべき文章もあれば、今週中に読めばいいと判断する文章もあります。どんな文章であろうと、決して全員が詳細まですべてをその場で読むわけではありません。　この判断が素早くできるよう、伝わる文章では、大事なポイントが30秒で分かることが必要です。

© 2024 Aguri Otsuka All Rights Reserved. 出典：海保博之. 「心理学者が教える読ませる技術
聞かせる技術心を動かす、わかりやすい表現のコツ」わかるとは、入力情報が、人間の情報処理系の中で適切に処理されて、頭の中に格納されている既有の知識に同化させることができたか、あるいは既有の知識をうまく調節できることである認知心理学における「わかる」の定義既有の知識に個人差がある「わかる」の仕組み

© 2024 Aguri Otsuka All Rights Reserved. 「わかる」の仕組み入力情報を処理するときに作用するのが、
ユーザーごとのメンタルモデル

© 2024 Aguri Otsuka All Rights Reserved. 認知心理学における「モデル」科学的な  モデル 
ではない！長期記憶の中に作られた「一貫した」知識のまとまり知識を構成している要素間の様々な関係によって、作られている

© 2024 Aguri Otsuka All Rights Reserved. メンタルモデルと科学的なモデルの違いメンタルモデル「知識のまとまりをつけている関係が多彩」
科学的なモデル「演繹論理」や「帰納論理」さまざまな事実や  事例から導き出される傾向をまとめあげて結論につなげる一般的かつ普遍的な事実を前提として、そこから結論を導きだす

© 2024 Aguri Otsuka All Rights Reserved. メンタルモデルの具体例を見てみよう！出典：海保博之「心理学者が教える読ませる技術
聞かせる技術心を動かす、わかりやすい表現のコツ」　我々は、自分の身のまわりの環境について、一定のまとまりのある認識を持ち、それに基づいて環境に働きかけている。机があり、パソコンがあり、本箱があり、……という認識ではなく、「机の上にパソコンがあり、机の左側に本箱がある、……」という具合に、あるまとまりをもった世界、別の言い方をするなら、部分と部分との間に関係のついている世界を自分の頭の中に作り上げる。そのような一貫した認識があるからこそ、本を取るときは左手をのばし、パソコンを使うときは机の前に座るという行為がスムーズにできる。　文化や生活習慣がまったく異なる外国へ行ったときのように、きわめて目新しい場面に直面したときや、瞬間的に強いストレスにさらされたりして自分の情報処理系が何らかの理由でうまく働かなくなってしまったときなどには、ばらばらな認識が発生する。そして「何が何やらわからない」「何をどうしていいかわからない」となる。　人間は、普通、自分の身のまわりについて、それなりのまとまりをもった認識をしている。時には、あまり適切でなかったり、誤っていたりすることがあっても、である。この認識を成立させているのがメンタルモデルである。

© 2024 Aguri Otsuka All Rights Reserved. メンタルモデルの具体例を見てみよう！出典：海保博之「心理学者が教える読ませる技術
聞かせる技術心を動かす、わかりやすい表現のコツ」　我々は、自分の身のまわりの環境について、一定のまとまりのある認識を持ち、それに基づいて環境に働きかけている。机があり、パソコンがあり、本箱があり、……という認識ではなく、「机の上にパソコンがあり、机の左側に本箱がある、……」という具合に、あるまとまりをもった世界、別の言い方をするなら、部分と部分との間に関係のついている世界を自分の頭の中に作り上げる。そのような一貫した認識があるからこそ、本を取るときは左手をのばし、パソコンを使うときは机の前に座るという行為がスムーズにできる。　文化や生活習慣がまったく異なる外国へ行ったときのように、きわめて目新しい場面に直面したときや、瞬間的に強いストレスにさらされたりして自分の情報処理系が何らかの理由でうまく働かなくなってしまったときなどには、ばらばらな認識が発生する。そして「何が何やらわからない」「何をどうしていいかわからない」となる。　人間は、普通、自分の身のまわりについて、それなりのまとまりをもった認識をしている。時には、あまり適切でなかったり、誤っていたりすることがあっても、である。この認識を成立させているのがメンタルモデルである。バグの要因ありすぎ！

© 2023 Aguri Otsuka All Rights Reserved. 語釈は、こう実際の、仮の、想像上の状況に対する
心理的なイメージ

© 2024 Aguri Otsuka All Rights Reserved. 1 個人の既有知識によって作られる恣意的なモデルである 2
個人的な体験に基づいて、一貫している 3 世の中や科学的モデルから見て、現実的でないことがある 4 状況に対する知識の量・質に応じて、変わる 5 試行錯誤的に突然変わることがあるメンタルモデルの特徴

© 2024 Aguri Otsuka All Rights Reserved. 出典：海保博之「心理学者が教える読ませる技術聞かせる技術
心を動かす、わかりやすい表現のコツ」メンタルモデルは、恣意的であるモデルはこうでなければならないということがない。長期記憶にある既有知識の中から、当面する世界と対処するのに使えそうなものを見つけて、「勝手に」一つのミニチュア世界のモデルを作る。したがって、同じ文字入力についてのメンタルモデルでも、手書きの経験しかない山田さんと、パソコン入力を得意とする高橋さんとでは、まったく異なるモデルを作り上げることの方が、むしろ普通である。

心を動かす、わかりやすい表現のコツ」メンタルモデルは、一貫している一度作り上げたモデルは、そのモデルの中では一貫した知識の構造を持っている。ただし、この「一貫した」は、科学者が作り上げるモデルのように論理的に一貫しているという意味ではない。同じ状況に対しては、いつも同じモデルを使うとか、ほぼ同じ行動を導くとかいった意味で、一貫しているということである。この一貫性を支えているのは、個人的な体験である。状況との体験的なかかわりを通して、メンタルモデルは作り出される。したがって、知識要素間の関係を特徴づけるのは、論理的な関係よりも、むしろ「あれをしたらこれが起こった」（因果関係）、「あれとこれとはよく一緒に起こった」（相関関係）などが中核となる。

心を動かす、わかりやすい表現のコツ」メンタルモデルは、世の中の状況との対応は完全ではないその対象となっている世界との対応は「完全なもの」ではありえない。だからこそ、いろいろなモデルが作られる。ましてや、ひとりひとりの心の中に「勝手に」作られるメンタルモデルでは、他人から見れば、あるいは、科学的なモデルから見れば、およそ現実的でない、ということがあっても不思議ではない。ただ、その人にとっては、その対象となっている状況とかかわるのには、当座のところ不都合はない。だからこそ、一貫してその人はしつこくそのモデルを持ち続けているのである。

心を動かす、わかりやすい表現のコツ」メンタルモデルは、状況に応じて変わる非常に抽象的な場合もあるし、具体的な場合もある。また、粗い場合も、精緻な場合もある。状況についての知識の量と質に応じて、メンタルモデルは自在にそのレベルや内容を変える。一般には、状況についての知識が貧弱なときにはマクロなメンタルモデル、豊富なときはミクロなメンタルモデルが構築されるようである。

心を動かす、わかりやすい表現のコツ」メンタルモデルは、試行錯誤的に状況とかかわらせるエラーをしながら現実の世界からのフィードバックを受けて、モデルは変更されていく。その変更は、おおむね、突発的で必然性がない。

© 2024 Aguri Otsuka All Rights Reserved. つい、“UI/UX”って言っちゃうわけ｜aguringoの個人的な見解ですメンタルモデルの特性から考えると、"ユーザーが解釈した"一貫した体験があることは確かで、自身の経験が一貫していると認識しているので、UIとUXの境目を自覚できないの
だと考えられます。しかし、"ユーザーが解釈した"一貫した体験が提供者が意図した体験とはまったく別物になる可能性があること、人の認知のシステムから生じる結果は多様でアンコントローラブルだということは、プロダクト開発をするうえでつねに意識しておきたい。個人的には、UIつまりユーザーとの接点を考え作る人たちが無意識に「一貫した体験」と言ってしまうことは驕りでしかなく、早く捨てた方が良いと思っています。ちゃんと理解したうえでの謙虚さというか、一種のあきらめを胸に秘めつつ抗う手段が、愚直に"一貫したものを作る"なんだよなぁって、いつも考えています。

© 2023 Aguri Otsuka All Rights Reserved. 広義に捉えられることもあるよ（フォロー）出典：「UX白書｜はじめに」ユーザエクスペリエンスという用語は、
ユーザビリティ、ユーザインターフェース、インタラクションエクスペリエンス、インタラクションデザイン、顧客経験、ウェブサイトアピール、感情、＂ワオ効果＂、一般的経験の同義語として、また、これらの全てや多くの概念を包括した用語として、よく用いられます。

© 2023 Aguri Otsuka All Rights Reserved. 広義に捉えられることもあるよ（フォロー）出典：「UX白書｜はじめに」ユーザエクスペリエンスという用語は、
ユーザビリティ、ユーザインターフェース、インタラクションエクスペリエンス、インタラクションデザイン、顧客経験、ウェブサイトアピール、感情、＂ワオ効果＂、一般的経験の同義語として、また、これらの全てや多くの概念を包括した用語として、よく用いられます。定義は時と場合による

© 2024 Aguri Otsuka All Rights Reserved. いきなりですが、質問ユーザーはどんな目的で SmartHRを使っている
と思いますか？

© 2024 Aguri Otsuka All Rights Reserved. なぜ「メンタルモデル」を意識するかメンタルモデルを使ってショートカットする
情報処理の効率を上げるメンタルモデルの適用を慎重にゆっくり時間をかけるよく観察し情報を精査し判断して誤らないようにするたくさんのことを「速く」「一気に」処理しようとする時、人間はメンタルモデルに頼らざるを得なくなる

© 2024 Aguri Otsuka All Rights Reserved. 出典：ジョン・ウェイレン「脳のしくみとユーザー体験認知科学者が教えるデザインの成功法則」「直感的に使える！」の感想のワケ
ほとんどの人は論理を無視して心の近道を使いがちだし、余裕がなくなれば、経験則に頼って「サティスファイシング」を行う。つまり、よく考えて意思決定を行うのではなく、思い出しやすく、正しいように感じる選択肢を選ぶ。

© 2024 Aguri Otsuka All Rights Reserved. 〇〇してほしい伝えたいこと
テキストふむふむ処理〇〇しよう！伝わるユーザー求める行動を  ユーザーが理解できる  ように翻訳する

© 2024 Aguri Otsuka All Rights Reserved. 考えることを整理するために何を考慮すれば  良いのか 
不安しかない…

© 2024 Aguri Otsuka All Rights Reserved. ライティングのダブルダイヤモンド２. 整理
　する１. 集める　調べる３. 意図を　明確にする４. 書く５. 磨く発散収束収束発散イギリスのデザインカウンシルが提唱したデザインプロセスのモデル、「ダブル・ダイヤモンド」から発想を得てます https://note.com/aguri/n/n428d4cc42af4

© 2024 Aguri Otsuka All Rights Reserved. プロダクトライティングのダブルダイヤモンド２. 整理
　する１. 集める　調べる３. ユーザーが達成したいこと　明確にする４. 書く５. 整える発散収束収束発散

© 2024 Aguri Otsuka All Rights Reserved. 集める・調べる、整理する、ユーザーの目的を明確にする１. 集める
　調べる２. 整理　する３. ユーザーが達成したいこと　明確にする４. 書く５. 整える発散収束収束発散どのUIで表示される UIテキストの役k だれに (担当者・従業員f いつ・どのように   (テキストを目にする状況f 何をして欲しいのか

© 2024 Aguri Otsuka All Rights Reserved. GE 画面単位で見る（最低限0 (E
ユーザーストーリーで見7 3E 拡張性で見る視座の切り替えとは？

© 2024 Aguri Otsuka All Rights Reserved. ユーザーストーリー単位で UIテキストを仕上げる PH
ユーザーストーリーで見る

© 2024 Aguri Otsuka All Rights Reserved. ・テキストもUIの一部で、インタラクションの中に含まれるから（操作を進めながら、目に飛び込んでくる。ユーザー
は文章を読むために操作しているわけではない）・オブジェクト違いの同じ操作画面間のテキストを揃えたい・ユビキタス言語としてオブジェクト名が決まっていて、実装時にライティングガイドに則れば、さほど大きなブレは生じないので、最後に見直しても手戻りは少ないはず… なぜ、ユーザーストーリー単位なのか？

© 2024 Aguri Otsuka All Rights Reserved. ・ユーザーストーリー単位で操作ができるようになったら、 UIテキストを修正
・ユビキタス言語の見直しをした場合には、ドキュメントも修正実例：スキル管理のUIテキスト実装の流れ開発のチケットはなるべく小さくしている SmartHRのfigmaのデータは中間生成物ではない仮説検証を繰り返しながら開発するうえで欠かせない

© 2024 Aguri Otsuka All Rights Reserved. ・従業員のスキル情報の一括登録ストーリーの文言修正・
マスターデータ設定周りの文言修正・【文言修正】KAT-686｜申請ストーリー・バックグラウンド処理の文言修正興味があったら、Pull Request見てみてね

© 2024 Aguri Otsuka All Rights Reserved. 1stリリースでは管理者から従業員へ情報の登録を「依頼」するだけだったので、「依頼」というオブジェクトになりそうだったところを「申請」に変更
https://smarthr-inc.docbase.io/posts/2903773

© 2024 Aguri Otsuka All Rights Reserved. 「わかる」と「わかりやすい」わかるわかり
やすい「何と同じか、何と違うかX U どのカテゴリに属すのS U 属するカテゴリの他のものとはどう違うのか? 「何と同じか、何と違うか」が自明な状w U カテゴリが意識されてい U 同カテゴリのものの違いが名前から理解できる

© 2024 Aguri Otsuka All Rights Reserved. 3つの関係命名分類
構造化教科書的には「構造化→組織化→ラベリング」の順に情報整理すると言われていますが、「これでユーザーにわかるかな？」というレビューすることを忘れない！

© 2024 Aguri Otsuka All Rights Reserved. 情報密度の高い言葉を使う時に気をつけたいことリーダブルコードでは、コードレビュー時のコメントを簡潔にするため
「情報密度の高い言葉を使う」ことを推奨しています情報密度の高い言葉、つまり概念を一言で表した名前は、ひと言で多くの情報を伝えられるので、便利一方で、言葉の意味・解釈が違っていた場合には、コミュニケーションのズレに繋がります

© 2024 Aguri Otsuka All Rights Reserved. 出典：ジョン・ウェイレン「脳のしくみとユーザー体験認知科学者が教えるデザインの成功法則」主役は「仕様」ではなくてユーザー
顧客が実際に発する言葉に耳を傾ければ、彼らがよく使っている言葉や、持っている専門性のレベル、ひいては想定しているプロセスがわかってくる。それを活用すれば、顧客が期待しているものに近い体験をデザインしたり、プロセスが予想と異なっていることへの注意喚起をしたりできる。

© 2024 Aguri Otsuka All Rights Reserved. ・どんな言葉を使っているか・
その言葉をどんな意味で使っているか・（使っている言葉から）どの程度の知識がありそうか商談やチャットログから　　が把握する観点

© 2024 Aguri Otsuka All Rights Reserved. 環境の変化によってメタファーが通じなくなることも https://note.com/47178/n/n749c31e82edf https://note.com/47178/n/n749c31e82edf
トレー… お盆？タスクを溜めておく場所→「トレイ」

一般名詞と混同されないか？・どうやってユーザーのメンタルモデルを構築する？できる限り自然な動線上でインプットを試みるフィーチャー開発するぞー！という時のライティングの難所考え方として説明済み

一般名詞と混同されないか？・どうやってユーザーのメンタルモデルを構築するかできる限り自然な動線上でインプットを試みるフィーチャー開発するぞー！という時のライティングの難所考え方として説明済み

© 2024 Aguri Otsuka All Rights Reserved. 出典：「ちいさくはじめるデザインシステム」 UIテキストの作成プロセスとガイドライン UIテキストは、おおまかに「調査・分類・抽象化」の流れで作成して
いきます。まず、既存のUIテキストを網羅的に調査します。具体を把握しなければ、何が「当たり前」なのかわかりませんし、何に対して「整合性」を担保すればいいのかもわかりません。そして、既存のUIテキストの共通点を見つけて分類し、どのような概念や操作体系を示しているのかを抽象化します。事例の集まりに「意味」を見つけ、UIテキスト作成に利用できる情報へと変化させるプロセスです。最後に、揃えるべき点や変えるべき点を判別したうえで、言葉を選びます。

© 2024 Aguri Otsuka All Rights Reserved. 実例：「入力必須」か「必須入力」か https://smarthr-inc.docbase.io/posts/2178376 正）　項目を指す時［入力必須項目］ 
　　　設定時のラベル：［入力必須］もしくは［必須］（UIによって判断）  　　　フォームラベル：［必須］   誤）　項目を指す時［必須入力項目］  　　　設定時のラベル：［必須入力］

Product-Writing

Product-Writing

More Decks by aguri otsuka

Other Decks in Design

Featured

Transcript