error-message-brainstorming

Jump to: navigation, search

Contents

Error Message Brainstorming

Typical Web applications emit text messages to inform the user of error situations -- either user errors ("Invalid user name or password", "Failed to enter required fields") or system errors ("can't connect to database server", "Call to member function 'foo' on null object.").

There are a number of use-cases for having a standardized, machine-readable format for HTML error messages.

Some potential fields

Brainstorming examples

Below are some brainstorming examples based on the above proposed fields, in roughly increasing order of complexity. Note that they all use "user login" errors, but that this specification is for any kind of error.

Just a text error message:

    <div class="error">Login failed. User name and password not found.</div>
 

A text error message with a uniquely identifying error code:

    <div class="error"><abbr title="E3316">Login failed. User name and password not found.</abbr></div>
 

An error with some options for correcting the situation:

    <div class="error"><p>Login failed. User name and password not found.</p>
         <ul class="instructions">
             <li>Check your spelling and try again.</li>
             <li>Check that the CAPS LOCK key is not on.</li>
             <li>Use the <a href="password-recovery">password recovery</a> tool to get a new
                 password sent to you.</li>
             <li>Contact our <a href="customer-support">customer support</a>.</li>
         </ul>
    </div>
 

An error with step-by-step instructions for fixing the situation:

    <div class="error"><p>Login failed. User account locked due to unconfirmed email address.</p>
         <ol class="instructions">
             <li>Use the <a href="email-confirmation">email confirmation</a> tool to get a new
                 confirmation email sent to your account.</li>
             <li>Copy the confirmation code you receive in the email
                 into the <a href="confirmation-code">confirmation code</a> form.</li>
             <li>Enter your new password.</li>
         </ol>
    </div>
 

See also

error-message-brainstorming was last modified: Thursday, June 28th, 2007

Views