Solutions for Repairing Poorly Written Instructions

Problem

Solution

 

Too little information-

            vital information missing

 

Include all information your users will need to accomplish the task.

Have a typical user test your instructions

 

 

Too much information-

            extra material confuses the user.

 

 

Only include information relevant to the task to be performed.

 

Information is difficult to understand

 

Write clearly and simply.

Use illustrations.

Consider decision tables.

Use step-by-step format.

 

 

Information difficult to find.

 

Use headings and overview summaries.

 

 

Information in the wrong place

            or in the wrong order

 

 

Use a vertical step-by-step format.

Use headings and visual cues.

 

Information types mixed together, e.g.,

          directions mixed with guidelines,

           restrictions, or  policies.   

 

Group similar information types to avoid user confusion.