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

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

9月 2026

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

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

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

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

---

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

<https://engineer.company/ja/portfolio/rewrote-error-messages-to-stop-blaming-users/>
