」「できませんでした。」といった口調はユーザのモチベーションを低下させます。できる限り、協力して解決に結びつけるような口調で書きます。電話番号が間違っています。有効な電話番号を入力してください。プログラム目線ではなくユーザー目線で書くエラーメッセージは、プログラム目線の言葉ではなく、ユーザーが読んで分かる言葉で書きます。「画像データがありません」「ユーザ情報が取得できませんでした」「認証に失敗しました」「取得に失敗しました」「空白が入力されています」といったメッセージはプログラムの観点で書かれています。なくて、「新しい画像を登録してください」のように、ユーザーから見て内容が理解できるように書きます。9000以上の数字は入力できません。時給は9000円以下で入力してください。何が起きているかを説明するなぜユーザーのタスクが完了できないのかを書きます。どのような現象が起きているのか、どのような操作が悪かったのかを簡潔に説明します。自動的にサインアウトしました。アクティブでない状態が続いていたので、お客様の情報を守るためにサインアウトしました。すれば解決できるのかを伝える具体的な解決策を書きます。ユーザーが次に何をすれば、目的としているタスクを完了させることができるのかを明らかにします。住所を入力してください。エラーメッセージの種類エラーメッセージには、インラインに表示するエラーメッセージや、モーダルに表示するエラーメッセージ、別ページに遷移するエラーメッセージという種類があります。インラインに表示するエラーメッセージインラインに表示するエラーメッセージとは、ユーザーがアクションを行う同一画面上に表示するエラーテキストのことです。ユーザーのアクションを阻害しないためストレスが最も少ない方法です。インラインエラーは各フォームの項目の下と、ページの最上部か送信ボタン付近に表示します。各項目の下に表示する。入力フォームの下にエラーの内容を記載します。ユーザーにとってのストレスが最も少ないのがこのタイプです。出典:Amazonページ最上部か送信ボタン付近に表示する。複数のエラーがあることを伝える場合や、各項目の下に表示するエラーメッセージに該当するものがない場合には、ページ最上部か送信ボタン付近にエラーメッセージを表示します。場合によってはトーストで表示することもあります。出典:airbnbモーダルで表示するエラーメッセージそのページのメインのアクションが取れず、別のページでアクションが必要な場合には、モーダルでエラーメッセージを表示します。モーダルで表示することで、ページからの迂回をうながすことができます。モーダルのタイトルには、アクションタイトルをつけ、ボタンもアクション名をつけます。ディスクリプションには、発生した問題や、問題を解決するメリット、アクションの説明を「〜をするには、〜をしてください。タイトル:支払方法を追加してくださいディスクリプション:支払方法が利用できません。購入を完了するには新しい支払い方法を登録して下さい。別ページに遷移するエラーメッセージ別ページに遷移するエラーメッセージとは、システムの不具合によるエラー(500エラー)やURLが見つからない(404エラー)、メンテナンス中のエラー(503エラー)など、それ以上の行動ができない場合に、別のページに着地させるエラーです。タイトルにはアクションタイトルを記載します。「サーバーエラーが起きました」というようなエラーの説明は記載しません。ユーザーが何をすべきかを記載します。ディスクリプションには、問題の説明と、アクションの説明を「〜をするには、〜をしてください。タイトル:インターネットに接続してください。説明文:ルートを検索するには、WiFiをオンにしてインターネットに接続してください。ボタン:WiFiに接続するエラーメッセージの管理をソースコード上で分離するシステムの規模が大きくなる場合には、エラーメッセージを専用のファイルに記載して、ロジックから分離するように努めます。分離したエラーメッセージは、ロケールファイルやコンフィグファイルなどに配置します。エッジケースでは、エラーメッセージを修正するのが困難になるためです。月末のバッチ処理に、課金のオンライントランザクションが衝突するといった極めて稀に発生するエラーの場合には、エラーメッセージを再現して修正することがほぼ不可能となります。エンジニアがロジックを組み上げる過程でエラーメッセージを設定して、ディレクターがエラーメッセージをまとめて確認するようなフローの中では、エラーメッセージの修正が難しくなるのです。エラーメッセージを一元管理することで、そのエラーを再現させなくともエラーメッセージを修正できるようになります。コード上は、変数名から起こりうる条件を想起できるようにして、必要であれば発生方法をコメントで記載しておきます。“お客様の操作がシステム処理のタイミングと重複しました。時間をおいて再度おためしください。";エラーが発生しないようにするエラーメッセージを書く以前に、エラー自体が発生しないようにシステム自体を見直す観点も必要です。入力規則をディスクリプションに書いておく、ハイフンの自動変換を行う、大文字・小文字を自動修正する、半角・全角を自動変換する、フリガナはカタカナしか入力できないようにする、といった工夫をすることで、ユーザーに大きなストレスをかける前に、解決できるように努めます。Media、2020前のページディスクリプション前のページディスクリプションwordrabbitで社内の表記ルールを瞬時に統一ワードラビットのスタイルガイドを使えば、用字用語を統一して、システム全体に一貫性を持たせることができます。統一したい用語を登録したり、注意喚起をしたい用語に説明文を設定したりすることで、メンバー全員で簡単にルールを共有して、プロダクト開発にかかる時間が削減できます。欧米学問のテクニカルライティングに基づいた執筆技法で、プロダクトライティングや、専門性が高い記事の執筆を行う。PR会社、ソフトウェアメーカー、スタートアップの立ち上げを経て、Remediesを起業。wordrabbitで執筆した記事は累計1,000万PVを超える。Xをフォローする本ガイドラインの著作権はwordrabbitに帰属します。参考にしていただく場合には出典元リンクを明記してください。