Re: Sloppy writing, sloppy thinking
I certainly share Andrew's dislike for those menu-oriented
approaches to user-guide oraganization: [...]
Usually, the better way is task-oriented: "To achieve this result,
follow this procedure." And to do that properly requires an
undertanding of what your users want to achieve.
IMHO, often the best way is to have both, because they answer different types of questions a user can have: A task-oriented section is useful for finding out how to achieve a particular goal, while a separate reference section organized along the lines of the user interface is useful for finding out what a particular element does. In particular, a reference section makes it easier to explain numerous options that some elemnts may include without having to interrupt the explanation of a task.
Regards
Jan Henning
--------------------------------------------------------------------
Jan Henning
ROSEMANN & LAURIDSEN GMBH
Am Schlossberg 14, D-82547 Eurasburg, Germany
Phone: +49 700 0200 0700, Fax: +49 8179 9307-12
E-Mail: henning -at- r-l -dot- de, Web: www.r-l.de
--------------------------------------------------------------------
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Robohelp X3, from eHelp, lets you quickly and easily create professional Help systems for all your Windows and Web-based applications, including Net.
Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module.
Order RoboHelp today: http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.
Follow-Ups:
- Re: Sloppy writing, sloppy thinking, Michael West
Previous by Author:
Re: Certification program??????????
Next by Author:
Re: Sloppy writing, sloppy thinking
Previous by Thread:
Re: Sloppy writing, sloppy thinking
Next by Thread:
Re: Sloppy writing, sloppy thinking
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads