TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
This is going on the assumption that the person running the wizard knows
enough about the application and/or dataset, and knows enough about the
finished result so that they are able to pick the correct option to get the
Often, a wizard will branch into different results based on selected radio
buttons or entered checkmarks. Yet, the person running the wizard might not
be sure what the results will be if one option is selected vs the other.
Also, stupid little things...example. Just this morning, I was using
Microsoft SQL Server client to export data from SQL databases to an Access
db. When it came time to pick the destination, I found out that it doesn't
create an mdb file, but I can only pick an existing one.
Maybe this is a poorly designed application, maybe a poorly designed wizard,
or maybe there is a good reason and the documentation should explain the
impact of possible actions.
Senior Technical Writer
jposada -at- book -dot- com
"There are those who look at things the way they are, and ask why... I dream
of things that never were, and ask why not?"
-----Robert Francis Kennedy, 1968 presidential campaign
> If a "wizard" requires documentation, I suggest putting the time and
> energy into improving the wizard. Wizards are essentially
> self-disclosing and interactive instructions, so having Help for a
> wizard is sort of like having a manual for the manual. (Which, of
> course, is sometimes done. Ugh.)
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.