Product-Writing - Speaker Deck

Product-Writing

by aguri otsuka

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

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

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

Slide 12

Slide 12 text

Slide 13

Slide 13 text

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

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

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

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

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

Slide 25

Slide 25 text

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

Slide 26

Slide 26 text

© 2024 Aguri Otsuka All Rights Reserved. 出典：海保博之「心理学者が教える読ませる技術聞かせる技術心を動かす、わかりやすい表現のコツ」メンタルモデルは、世の中の状況との対応は完全ではないその対象となっている世界との対応は「完全なもの」ではありえない。だからこそ、いろいろなモデルが作られる。ましてや、ひとりひとりの心の中に「勝手に」作られるメンタルモデルでは、他人から見れば、あるいは、科学的なモデルから見れば、およそ現実的でない、ということがあっても不思議ではない。ただ、その人にとっては、その対象となっている状況とかかわるのには、当座のところ不都合はない。だからこそ、一貫してその人はしつこくそのモデルを持ち続けているのである。

Slide 27

Slide 27 text

© 2024 Aguri Otsuka All Rights Reserved. 出典：海保博之「心理学者が教える読ませる技術聞かせる技術心を動かす、わかりやすい表現のコツ」メンタルモデルは、状況に応じて変わる非常に抽象的な場合もあるし、具体的な場合もある。また、粗い場合も、精緻な場合もある。状況についての知識の量と質に応じて、メンタルモデルは自在にそのレベルや内容を変える。一般には、状況についての知識が貧弱なときにはマクロなメンタルモデル、豊富なときはミクロなメンタルモデルが構築されるようである。

Slide 28

Slide 28 text

Slide 29

Slide 29 text

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

Slide 30

Slide 30 text

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

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

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

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

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

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

Slide 60

Slide 60 text

Slide 61

Slide 61 text

Slide 62

Slide 62 text

Slide 63

Slide 63 text

Slide 64

Slide 64 text

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

Slide 65

Slide 65 text

Slide 66

Slide 66 text

Slide 67

Slide 67 text

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

Slide 68

Slide 68 text

Slide 69

Slide 69 text

Slide 70

Slide 70 text

Slide 71

Slide 71 text

Slide 72

Slide 72 text

Slide 73

Slide 73 text

Slide 74

Slide 74 text

Slide 75

Slide 75 text

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

Slide 84

Slide 84 text

Slide 85

Slide 85 text

Slide 86

Slide 86 text

Slide 87

Slide 87 text

Slide 88

Slide 88 text

Slide 89

Slide 89 text

Slide 90

Slide 90 text

Slide 91

Slide 91 text

Slide 92

Slide 92 text

Slide 93

Slide 93 text

Slide 94

Slide 94 text

Slide 95

Slide 95 text

Slide 96

Slide 96 text

Slide 97

Slide 97 text

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

Slide 98

Slide 98 text

Slide 99

Slide 99 text

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