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

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

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

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

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

カテゴリー:
1フロントエンド開発	/ja/categories/frontend/	engineer.company	70
1セキュリティ	/ja/categories/security/	engineer.company	70
1テスト・品質保証	/ja/categories/testing/	engineer.company	70
1UX・UI設計	/ja/categories/ux-ui/	engineer.company	70
1プロダクト・要件	/ja/categories/product/	engineer.company	70
1文書作成	/ja/categories/documentation/	engineer.company	70

サービス:
1UI/UX設計・デザインシステム	/ja/services/ui-ux-design/	engineer.company	70
1プロダクト戦略・要件定義	/ja/services/product-strategy/	engineer.company	70
1技術文書の作成	/ja/services/technical-documentation/	engineer.company	70

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