コピーガイドライン（Copy Guidelines）

長いテキスト

マルチライン/ステップの指示やページや機能へのナラティブな導入のためのガイドライン。

これは文脈によって大きく異なるが、一般的なヒントは以下の通り。

1: 短縮形は友達！

会話的で、テキストをより親しみやすく、形式ばらない印象にする簡単な方法です。（そして、少しスペースを節約します：ウィンウィンです。）

2: 意味を追加せずに単語数を膨らませるフレーズはカットする。

これは特定の二つの状況で頻繁に発生します。まず、受動態で書くとき：

このブロックは単一の画像を表示するために使用できます。
「can be」や「is used」のようなフレーズを見たら：停止してください。受動態で書いています。より活発な文にしてみてください：
このブロックは単一の画像を表示します。
次に、宣言的な文を作る代わりに曖昧にする場合：
ギャラリーブロックは、エレガントなレイアウトで複数の画像を表示するのに役立ちます。
それは本当ですか？私たちはこのソフトウェアを作っています：それが何であるか、何をするかについて宣言的であることが許されています：
ギャラリーブロックは、エレガントなレイアウトで複数の画像を表示します。
私たちは「allows you to」というフレーズでもこれをよく行います。
プレフォーマットされたテキストは、タブと改行を保持します。
機能は誰かに何かをさせるものではなく、特定の目的を達成するために特定のことを行うツールです。彼らが何をするかを言ってください：
プレフォーマットされたテキストは、タブと改行を保持します。
より直接的な文はほぼ常に明確です。「can」、「be」、「might」、「allows you to」、「helps」という言葉を探してみてください—それらは最も一般的な原因であり、特にそれらの言葉を探すことは、あなたが引き締めることができるフレーズを見つける方法です。

3: 「簡単」、「容易」、および「ただ」に注意。

何が簡単かを決めるのは私たちではなく、ユーザーが決めることです。何かが簡単だと言って、ユーザーが簡単な体験をしなかった場合、それは私たちへの信頼を損ないます。「ただ」についても同様です—多くの人が「簡単」を避けることを知っていますが、それでも「ただ」を常に使用します。「ここをクリックするだけです。」 「ユーザー名を入力するだけです。」同じことです：何かが大したことではないと暗示していますが、ユーザーが何を大したことだと感じるかはわかりません。

具体的であることは、より安全で役立ちます。「簡単」や「単純」は、私たちが書いていない説明の短縮形です；それらを見るたびに、それらが何を代表しているのかを考える時間を取ってください。「ブロックを追加するのは簡単です」とは、「キーボードから手を離さずにページにコンテンツを追加できます」という意味かもしれません。素晴らしい！「簡単」に頼るのではなく、具体的なことを言ってください。

これが、これらの言葉を語彙から追放すべきだということではありません。カバー画像ブロックが今は少ない設定で済むことを説明するツールチップを書くか、カスタムブロックの迅速な作成のためのツールを構築していることについてのメールを書く場合、カバー画像ブロックが簡素化されたと言ったり、カスタムブロック作成を容易にするために取り組んでいると言ったりすることは正当です—そこでは、用語は説明的で相対的です。しかし、何かが簡単または単純であるという絶対的な主張をするためにそれらを使用（または過剰使用）している方法を探し、それをより具体的で明確にする機会として利用してください。

4: 「私たち」に注意。

テキストや指示が「私たち」を多く使用する場合、それはテキストの焦点がソフトウェアの背後にいる人々にあり、ソフトウェアを使用している人々にはないことを意味します。時にはそれが実際に望むことですが、通常はそうではありません。焦点は通常、ユーザー、彼らのニーズ、そして彼らがどのように利益を得るかにあるべきであり、「私たちがしたこと」や「私たちが望むこと」ではありません。

私たちだけが自分たちがしたことや望むことを気にしています；ユーザーはただ機能するソフトウェアを望んでいます。「私たち」が多く見られる場合、あなたが書いていることをユーザーの利益や成功に焦点を当てるように再構成すべきかどうかを考えてください。

箇条書きリスト

(ダハ) 箇条書きリストを書くためのガイドライン。

1: すべての箇条書きで文の構造を平行に保つ。

平行構造はリストを迅速に読みやすくします—その予測可能性は読者の認知負荷を軽減します。

良い例：

このブロックで何ができますか？たくさんのこと！

• 引用を追加する。
• お気に入りのリンクを強調する。
• 複数の画像を表示する。
• 箇条書きリストを作成する。
  すべての箇条書きは完全な文であり、ピリオドで終わります。（リストが一言または二言のアイテムの集まりである場合、それらはしばしば単一の通常の文に変わることができます—読みやすく、スペースを節約します。）各行は、ブロックが何をできるかをユーザーに伝える動詞で始まります。文の主語は常にユーザーです。

ユーザーはこのリストを迅速に吸収できます。なぜなら、最初の項目を読んだ後、残りをどのように読むかを理解し、どの情報が見つかるかを知っているからです。

あまり良くない例：

このブロックで何ができますか？たくさんのこと！

• 引用を追加できます。
• お気に入りのリンクを強調しています。
• 複数の画像を表示します。ギャラリーに最適です！
• 箇条書きリスト
  ここでは、各行が異なる表現を持ち（動詞で始まるものもあれば名詞で始まるものもあり）、文の主語が変わります（時にはあなた、時にはブロック）。いくつかの行には追加の説明があり、いくつかにはありません。不完全な文があり、句読点が一貫していません。

このリストを読むのはより多くの作業が必要です。なぜなら、読者は各箇条書きを新たに解析しなければならないからです。彼らは各箇条書きが類似の情報を含むと仮定できません。

注：これは、すべての箇条書きが非常に短く、動作動詞で始まる必要があるという意味ではありません！「予測可能」は「単純」である必要はありません。それは単に、各箇条書きが同じ文の構造を持つべきであることを意味します。このリストも良いでしょう：

このブロックで何ができますか？たくさんのこと！

• 引用を追加してみてください。時には他の誰かが最も良いことを言った！
• お気に入りのリンクを強調するために使用してください—リンクを共有することはインターネットの通貨です。
• 複数の画像を表示するギャラリーを作成し、最高の写真を見せてください。
  ここでは、各箇条書きがよりユーザー中心の動詞で始まり、より興味を引くための補足情報が含まれています。句読点は少し変わりますが、基本的な構造が同じであるため、読みやすさは保たれています。

2: 疑問がある場合は、動詞から始める。（ただし、常に同じ動詞ではありません。）

動詞から始める必要がありますか？いいえ。しかし、迷った場合、通常は動詞から始めるのが間違いではありません（特に箇条書きリストは一連のアクションや可能なアクションを説明していることが多いため）。

純粋に指示的なシンプルなリスト（例：ユーザーに決定を下させる必要があるUIコピー）では、すべての箇条書きを同じ動詞で始めるのが良いかもしれません：

続行するには、アクションを選択してください：

• シンプルなテキストブロックを追加する。
• 引用ブロックを追加する。

• 画像ブロックを追加する。
  リストがより説得力のあるものである場合（例：機能の利点をリストアップして誰かを説得しようとしている場合）や、複数のステップの指示を含む場合、読者を引き込むために動詞を変える必要があります。上記の例のように：
  このブロックで何ができますか？たくさんのこと！

• 引用を追加してみてください。時には他の誰かが最も良いことを言った！

• お気に入りのリンクを強調するために使用してください—リンクを共有することはインターネットの通貨です。
• 複数の画像を表示するギャラリーを作成し、最高の写真を見せてください。
  これらは厳密なルールではありません—たとえば、説得力のあるリストで同じ動詞を使用してより焦点を絞り、強力にすることを選択するかもしれません。しかし、これは堅実なリストのための良い出発点です。

3: 何かが明らかにリストである場合、それがリストであることを教える必要はありません。

良い例：

このブロックで何ができますか？たくさんのこと！

• 引用を追加する。
• お気に入りのリンクを強調する。

• 複数の画像を表示する。
  あまり良くない例：
  このブロックで何ができますか？たくさんのこと！ここでの使用例をいくつか示します。

• 引用を追加できます。

• お気に入りのリンクを強調しています。
• 複数の画像を表示します。ギャラリーに最適です！
  明確さを最大限に保ちつつ、ユーザーを信頼するバランスを見つけてください。一方で、人々が指示を読まないことがあることは知っています；他方で、冗長性はユーザーに私たちが彼らを愚かだと思っていると感じさせることがあります。

4: 太字は時には友達です。

箇条書きリストの重要な情報に読者の注意を引くために使用します。これは、箇条書きに補足的だが最終的には二次的な情報が含まれている場合に特に便利です。

「重要な情報」は、まあ、重要です：太字は目を引くので、特定の箇条書きの最も重要な情報に固執してください：

このブロックで何ができますか？たくさんのこと！

• 引用を追加してみてください。時には他の誰かが最も良いことを言った！
• お気に入りのリンクを強調するために使用してください—リンクを共有することはインターネットの通貨です。

• 複数の画像を表示するギャラリーを作成し、最高の写真を見せてください。
  逆に、あまりにも多くのものを太字にすると視覚的な混乱を引き起こします：
  このブロックで何ができますか？たくさんのこと！

• 引用を追加してみてください。時には他の誰かが最も良いことを言った！

• お気に入りのリンクを強調するために使用してください—リンクを共有することはインターネットの通貨です。

• 複数の画像を表示するギャラリーを作成し、最高の写真を見せてください。
  リストが短く基本的な場合は、気にしないでください—太字はただ忙しさを加えるだけです。
  このブロックで何ができますか？たくさんのこと！

• 引用を追加する。

• リンクを強調する。
• 複数の画像を表示する。
  言葉の欠如はそれ自体で焦点を作り出します；これ以上追加する必要はありません。
  

UIの説明

機能の一行説明を書くためのガイドライン、またはオプションを明確にするための短い説明。

1: 明確さが最優先！

ユーザーが特定のオプションを使用した結果を理解できない場合、あなたの言葉遊びがどれほど巧妙であっても関係ありません。言葉遊びやイディオムはしばしば不明瞭で、誤解されやすいです。もし使用する場合は、主なアイデアを説明するためではなく、補足情報として使用すべきであり、かなり広範囲の人々に理解されることが確実であるべきです。

2: セクション1を参照し、バルク追加フレーズに注意。

能動態は通常、より良い方法であり、スペースが限られているときに冗長なフレーズをカットすることが特に重要です。UI指示フレーズを短くして、より短く、より明確にすることができます：

Xをクリックすると、Yが発生します。
対
XをクリックしてYを行います。
追加の言葉がユーザーを製品の中で案内するのに役立つように感じることがありますが、追加の言葉は伝えられているポイントを隠すだけです：
「設定」ボタンをクリックすると、ポップアップが利用可能な高度な設定を表示します。
対
「設定」をクリックして高度な設定にアクセスします。
同様のフレーズは「Xを行うと…」や「Xを行いたい場合…」です。時には「Xを行いたい場合…」が完全に適切な決定ポイントがありますが、私たちはしばしばそれを「ここにできることがあります」と意味するために使用します。これは「Xを行うには…」とより簡単に表現できます。

3: 具体的であること。

アクションがユーザーが以前のアクションを完了することに依存する場合、必要なものと次に何が起こるかについて具体的に述べてください。私たちはしばしば「準備ができたら」とデフォルトにします。

何の準備ができたのですか？前提条件について具体的に述べてください。

「準備ができたら」とは、次のことを意味することがあります：

• もう一つのブロックを追加したいとき
• 投稿に満足しているとき
• 投稿の校正を終えた後
• 特徴的な画像を追加したいとき
• すべての設定を構成した後

そして、何かがすべてを意味する場合、それは実際には何も意味しません。指示が具体的であればあるほど、より役立ち、指示に従う人が製品に対して持つ信頼も高まります。

4: これはまだ書き物です。個性と興味を持つべきです。

明確さが最優先ですが、ここではスペースが限られていることが多いですが、UIテキストはまだ興味深く読むことができます。

説明の単一行はまだ完全な文であることができます。

リスト。番号付きまたは箇条書き。
対
リストを追加します。番号付きまたは箇条書き。
短縮形を使用することもできます。
リストを追加します。フォーマットオプションを提供します。
対
箇条書きリストを追加します—いくつかのフォーマットオプションを提供します。
句読点を使用して、言葉の流れを制御し、アイデアをリンクし、間を作ることもできます。
リスト。番号付きまたは箇条書き。
対
リストを追加します—番号付きまたは箇条書き。あなたの選択！
専門用語を避けて平易な言葉を使うこともできます。
無秩序または順序付きリストを追加します。
対
リストを追加します。番号付きまたは箇条書き。
（そして、繰り返す価値があるので：言葉遊びはやめてください！「個性」は—そしてUI指示では、そうあるべきです—微妙であるべきです。私たちは、人間が言ったように聞こえるテキストについて話しており、強制的な遊び心の試みではありません。）

5: 大文字に注意。

見出しやサブ見出しに関しては、大文字にする方法が二つあります：

タイトルケースでは、ほとんどすべての単語の最初の文字が大文字になります

文のケースでは、行の最初の文字だけが大文字になります

機能名やダッシュボードセクションは通常タイトルケースを使用します（「サイト統計」や「最近公開」などを考えてください）、一方、機能ラベルは通常文のケースを使用します（「ボタンを表示」や「コメントのいいねは」など、「いいね」は機能名なので大文字ですが、全体のラベルは文のケースを使用しています）。

UIコピーの全ページを見ているときは、一貫性を保ち、すべての類似の種類のコピー—見出し、ツールチップ、ボタンなど—が同じケースを使用していることを確認してください。

エラーメッセージ

理解可能で役立つエラーメッセージを書くためのガイドライン。

1: エラーメッセージにおける声/トーンを無視しないでください—それらは多くを伝えます。

声とトーンは、個々の言葉と同じくらい多くを伝えることができます。エラーメッセージはかなりの情報を伝える必要があり、通常はかなり短くする必要がありますが、トーンを犠牲にしたり、あまりにも否定的または肯定的な方向に行き過ぎたりしないようにしてください。

たとえば、誰かが投稿を公開しようとしているが、彼らのユーザー役割がそれを許可していない場合、次のように伝えることができますが、そうすべきではありません：

あなたのユーザー役割は不正確です。
ここでは、私たちは遠くて無関心に聞こえます。
停止！あなたにはこれを行う権限がありません。
ここでは、私たちは不必要に警戒心を抱き、厳格に聞こえます。
おっと、私たちはあなたにそれをさせることができません！
ここでは、私たちはあまりにも可愛らしく聞こえます。

エラーメッセージでも、直接的で前向き、かつ友好的でいることができます。どうやって？ヒント2から4を使って！

2: 可能な限り、解決への道を提供する。

良いエラーメッセージは、何かが間違っていることを知らせるだけではありません。

あなたのユーザー役割は不正確です。
わかりました、いいでしょう。それはなぜ重要なのですか？私はそれについて何をすればいいのですか？このメッセージは私にどのように役立ちますか？私のユーザー役割がなぜ重要なのか、そして私が望むアクションを完了するために必要な役割を取得する方法を知る必要があります。指示を提供しないエラーメッセージは、ユーザーに前進する道を残さず、エラーを引き起こしたアクションを繰り返すことを避けることができません。

3: スペースが限られているときに言葉を減らすために専門用語に頼らないでください。

あなたのユーザー役割は不正確です。サイト管理者に連絡してください。
ここで何かが進展しているかもしれません：今、私は物事に対処できることがわかります、これは良いことです。

しかし、そうでないかもしれません：私はまだ自分の役割が何であるか、なぜそれが重要なのかを知らない。さらに、今、私はサイト管理者が誰であるか、どのように連絡するかもわからない。

このエラーメッセージのすべての情報は技術的には完全に正しいですが、それが有用なことを伝えるわけではありません。理解と解決が目標である場合、技術的な正確さは必ずしもそこに到達するわけではありません。

「あなたのアカウントには投稿を公開する権限がありません」は、ユーザー役割UIの言語を使用していませんが、何が間違っているのかを説明しており、ユーザー役割が何であるかを知らなくても理解できます。そして、理解できるので、メッセージがここで終わっても、解決策を理解するのにより良い立場にいます：私は権限を取得する必要があることがわかります。

既存のUI言語との一貫性は素晴らしいですが、理解を妨げるときはそうではありません。

4: エラーがどこから来たのかを人々が理解していると仮定しないでください。

あなたのユーザー役割は不正確です。
私たちにとっては、ユーザーが何かを公開しようとしたときや、権限がない設定を変更しようとしたときにこのメッセージを受け取ったことは明らかに思えるかもしれません。ユーザーにとってはそれほど明らかではないかもしれません：人々は多くのことをクリックします、特に何かをする方法がわからないとき、そして私たちは常に自分がどのページや設定を見ていたか（またはなぜそれを見ていたのか）を覚えているわけではありません。

良いエラーメッセージは、ユーザーを方向付けるためのコンテキストも含んでいます。「あなたのアカウントには投稿を公開する権限がありません」は、彼らが投稿を公開しようとしていたことを思い出させ、エラーを引き起こした特定の障害物が何であるかを示しています。