利用者を責めないエラーメッセージに改訂
実際にはプロバイダーがアプリ専用パスワードを要求していたのに、サインイン拒否を利用者の入力誤りとするエラー表示を受け、文書化した文体基準に従ってメッセージを書き直し、プロバイダー名を明示するテストを加えた。
9月 2026
状況. 大手メール事業者へのサインインが失敗し、アプリはパスワード誤りと伝えた。しかし第三者クライアントにはアプリ専用パスワードが必要で、通常のものはいくら正確に入力しても拒否される。成功しない再入力を促し、別種のパスワードを作る実際の指示はどこにもなかった。
課題. 全体にある習慣の目に見える一例なので、個別に継ぎ当てず、文書化した基準に沿ってエラーを書き直す必要があった。
行動. 起きたことを述べる、他に原因があるのに利用者の誤りと示唆しない、可能なら次の行動を示す、という3条件を定めた。多くは少なくとも1つに違反し、ライブラリの生の文言は人の状況でなくプログラマー向けの条件を説明していた。該当例は事業者名、他クライアントに専用パスワードが必要なこと、その作成先を記した。回帰テストはその事業者への失敗を起こし、名前と必要な認証種類を示す句を要求する。何らかのエラーだけを求めれば旧誤文も通るため、壊れていた唯一の部分である内容を検証した。
結果. エラーは基準に従い、契機の例は旧文で失敗する試験を持った。ただし基準はレビューと1文の1試験で守られ、他の特殊要件を持つ事業者に同じ試験はない。範囲拡大は未解決で、種類ごと閉じたのでなく文書化した状態である。