# 利用者を責めないエラーメッセージに改訂

実際にはプロバイダーがアプリ専用パスワードを要求していたのに、サインイン拒否を利用者の入力誤りとするエラー表示を受け、文書化した文体基準に従ってメッセージを書き直し、プロバイダー名を明示するテストを加えた。

9月 2026

状況. 大手メール事業者へのサインインが失敗し、アプリはパスワード誤りと伝えた。しかし第三者クライアントにはアプリ専用パスワードが必要で、通常のものはいくら正確に入力しても拒否される。成功しない再入力を促し、別種のパスワードを作る実際の指示はどこにもなかった。

課題. 全体にある習慣の目に見える一例なので、個別に継ぎ当てず、文書化した基準に沿ってエラーを書き直す必要があった。

行動. 起きたことを述べる、他に原因があるのに利用者の誤りと示唆しない、可能なら次の行動を示す、という3条件を定めた。多くは少なくとも1つに違反し、ライブラリの生の文言は人の状況でなくプログラマー向けの条件を説明していた。該当例は事業者名、他クライアントに専用パスワードが必要なこと、その作成先を記した。回帰テストはその事業者への失敗を起こし、名前と必要な認証種類を示す句を要求する。何らかのエラーだけを求めれば旧誤文も通るため、壊れていた唯一の部分である内容を検証した。

結果. エラーは基準に従い、契機の例は旧文で失敗する試験を持った。ただし基準はレビューと1文の1試験で守られ、他の特殊要件を持つ事業者に同じ試験はない。範囲拡大は未解決で、種類ごと閉じたのでなく文書化した状態である。

役割: コンテンツデザイナー
=> /ja/categories/frontend/ カテゴリー: フロントエンド開発
=> /ja/categories/security/ カテゴリー: セキュリティ
=> /ja/categories/testing/ カテゴリー: テスト・品質保証
=> /ja/categories/ux-ui/ カテゴリー: UX・UI設計
=> /ja/categories/product/ カテゴリー: プロダクト・要件
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/ui-ux-design/ サービス: UI/UX設計・デザインシステム
=> /ja/services/product-strategy/ サービス: プロダクト戦略・要件定義
=> /ja/services/technical-documentation/ サービス: 技術文書の作成

=> https://advisory.engineer.company/ja/portfolio/rewrote-error-messages-to-stop-blaming-users/ このページのウェブ版
