インターフェースライティング
明確で簡潔であること。賢さより伝わりやすさ、バラエティより一貫性を重視します。最も優れたエラーメッセージとは、そもそもエラーが発生しないようにインタラクションを再設計することです。
コピーの表示方法（text-transform による大文字小文字の制御、テキストの切り捨て、スマート引用符）は better-typography の担当です。エラーのマークアップとアナウンス（aria-invalid、ライブリージョン）は better-accessibility の担当です。翻訳文字列のためのスペースは better-layout の担当です。
既存のトーンを把握する
コピーを書いたりレビューしたりする前に、周辺のコピーを読んでください。プロダクトの用語、ローカリゼーションの慣例、そしてボイスやコンテンツスタイルガイドに注意してください。
意図的なブランドボイスは欠陥ではありません。それが一貫性の欠如、曖昧さ、翻訳リスク、または状況にそぐわないトーンを生み出す場合にのみ、平易な言葉からの逸脱を指摘してください。
一つのボイス、柔軟なトーン
プロダクトには一つのボイスがあり、既存のコピーがそれを確立しています。局所的な編集が新しいボイスを発明することはできません。用語は一貫させてください。メニューで「アーカイブ」なら、トースト通知で「ストレージに移動」ではありません。トーンは状況に応じて変化します。
| コンテキスト | トーン |
|---|---|
| 成功メッセージ、オンボーディング、空の状態 | 温かみがあり、軽い表現も可 |
| 日常的な操作、設定 | ニュートラル、最小限 |
| エラー、破壊的な確認ダイアログ | 落ち着いて、平易に、遊び心ゼロ |
| データ損失、セキュリティ | 深刻、明確に |
読者に直接語りかける
指示コピーでは、「ユーザー」ではなく「あなた」と書いてください。エラーでは、「私たち」は曖昧さを招き、言い訳のように読めるため、「このコンテンツの読み込みに問題が発生しています」よりも「コンテンツを読み込めません」を優先してください。確立された一人称のボイスは、リスクの低いコピーで明確に読める場合に限り維持しても構いません。
所有格は控えめに使ってください。「お気に入り」は「あなたのお気に入り」よりも優れています。フローを通して一つの視点を維持してください。
賢い表現より平易な言葉
疲れた読者が一度で理解できる言葉を選び、機能しない単語はすべて削除してください。イディオム、口語表現、翻訳できないユーモアは使わないでください。
不要な性別表記は避けてください。「各購読者は自分のレシピを投稿できます」ではなく「購読者はレシピを投稿できます」。入力デバイスに合わせてください。タッチ操作では「タップ」、ポインターでは「クリック」、両方が可能な場合は「選択」を使用します。
変数を中心にフラグメントから文を組み立てないでください（`「あなたは