適切なエラーメッセージを書くための適切なリソースに関する推奨事項
ユーザーがシステムの使用方法を理解するのに役立つ適切なエラーメッセージを書くことは困難です。多くの場合、「エラーメッセージxは混乱を招く」というバグレポートを受け取ります。これは通常、言い換える方法についてチーム内で長い議論を巻き起こします。
優れたエラーメッセージの書き方について、優れたリソースはありますか？.
を探しています
- 本
- 良いブログ投稿記事
- 論文
- 研究成果
多くのデザイン本はそれについて言及しているが、それにほんの数段落を捧げている。
Web用の防御設計：エラーメッセージ、ヘルプ、フォーム、およびその他の危機的ポイントを改善する方法 （2004）by 37signalsは、2011年に廃止されましたが、コピーを含む不良エラー処理のさまざまな例を示しています、何が間違っているのか、どのように改善するのかを説明します。それをすべて「緊急時対応設計」と呼びます（本のタイトルは防御運転の概念に触発されています）。抽出されたパターンの一部は、今日でも関連しています。特に、Amazonは当時この分野のリーダーでした。
私がそれを読んだときに私がそれから取り除いた最大のことは、あなたのサイトが店のセールスマンのように振る舞うべきだということでした：私が迷子になったりアイテムを見つけられなかったりした場合、セールスマンは私に助けを求める質問をしますほとんどのウェブサイトは「見つかりませんでした」と言うだけですが、私が探しているものを見つけてください。以下は、最初の章からの抜粋です。
この本は、あなたのサイトの使いやすさを改善するために緊急時の設計を使用する方法を示します。次のことを学びます。
- 緊急時対応設計とは何か、なぜそれが重要なのか
- エラーを防止し、問題が発生したときに顧客を救うのに役立つ40のガイドライン
- エラーの回復と防止を長期的な設計プロセスの一部にする方法
- 最も支援が必要な領域に集中できるように、サイトの緊急時の設計を評価する方法
全体的に、この本はサイトやアプリのエラー処理を設計するのに役立ちますが、コピーについても特に優れた点がいくつかあります。第2章「問題の表示：明らかなエラーメッセージとアラートの表示」：
適切なエラーメッセージは、顧客に即座に通知します。
- エラーが発生したこと
- エラーは何ですか
- 回復する方法
この章には、サイト（2003年以降）の膨大な数の例が含まれています（その多くは存在しません）。各ディスカッションポイントには、物事を間違った方法で行う理由と理由、および物事をうまく行うサイトと理由の例が含まれています。
効果的なエラーメッセージを書くための優れたリソースも探していました。私が見つけた最も有用なリソースのセットはマイクロソフトからのものでした：
Microsoft Manual of Styleには、エラーメッセージに適用できる興味深い部分がいくつかあることもわかりました。ドキュメントの作成に関心がある場合は一読に値しますが、適切なエラーメッセージの記述方法にのみ関心がある場合は、長い（そしておそらく退屈な）文書です。
私はほとんどの時間をエラーメッセージの作成と確認に費やしているため、適切なエラーメッセージには次の3つの部分があるはずだと個人的に考えています。
- 問題
- 原因
- ソリューション
最初にこれらの3つの部分を書き留めることに集中し、次にテキストを編集して、より小さくてより人道的なものにします。私は エラーメッセージの書き方に関する投稿 を書きましたが、メッセージのこれら3つの部分を釘付けにした場合、問題の80％はすでに解決されています。