How to write procedures in help pages

Matthew Paul Thomas mpt at myrealbox.com
Tue Nov 20 04:48:07 UTC 2007


There's another interesting article in UXmatters about writing help.
<http://uxmatters.com/MT/archives/000242.php>

Summary:
*   People don't go to help unless they're stuck, and they leave ASAP.
*   When writing an instruction, make the first words the vital ones.
*   Consider situations that might prevent instructions from working.
*   Collapse instructions for simple steps (like opening a program).
*   Consider one-page overviews of "What you can do with X".

Cheers
-- 
Matthew Paul Thomas
http://mpt.net.nz/





More information about the ubuntu-doc mailing list