本文へ移動

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

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

利用者ではなく原因を示すエラーメッセージ

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

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

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

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

  • ペン、カリグラフィー、万年筆
    写真: SamuelFJohanns / Pixabay
  • 手紙、花、スズラン
    写真: beasternchen / Pixabay

この経験をお客様のプロジェクトに

「利用者を責めないエラーメッセージに改訂」を、お客様の組織の似た課題を考える出発点にしてください。この実績を支えたサービスを、お客様のプロジェクトにも提供できます。 配置、文言、操作の流れを整え、サポートに電話しなくても目的を果たせるようにします。

サービスを見る お問い合わせ

結果の背景を確かめる

この事例の状況、判断、結果をご覧ください。どの部分がお客様の制約の下でも生かせるか、どこに別の方法が必要かをご相談いただけます。 利用者を責めないエラーメッセージに改訂 — 利用者ではなく原因を示すエラーメッセージ

サービスを見る お問い合わせ

より多くの実績の 一つです — そのすべてをこのサイトで公開しています。

どの項目も、状況、課題、実施内容、変化という同じ構成で記載しています。

すべての実績を見る

必要な改善を定める

業務の流れ、既存のインターフェース、変更を必要とする利用者をお知らせください。検証可能な納品内容と、お客様のチームが保守を続けられる引き継ぎ内容を定められます。

料金を見る お問い合わせ

エラーメッセージで利用者を責めていませんか?

「利用者を責めないエラーメッセージに改訂」の判断の背景についてお尋ねください。仕事内容を説明し、お客様のプロジェクトを検討できる担当者が対応します。

サービスを見る
welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン
実際にはプロバイダーがアプリ専用パスワードを要求していたのに、サインイン拒否を利用者の入力誤りとするエラー表示を受け、文書化した文体基準に従ってメッセージを書き直し、プロバイダー名を明示するテストを加えた。のQRコード
このページを持ち歩くhttps://software.engineer.company/ja/portfolio/rewrote-error-messages-to-stop-blaming-users/