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.
1. everything a user needs to know to install the host hardware
2. everything a user needs to know to install the software
3. everything a user needs to know operate the software
4. As much trouble-shooting information as possible
AND
All of this information must be organized and written in a way that does not
insult the reader and allows the reader quick access to whatever information
the reader needs when she needs it. AND is not so large as to intimidate the
reader.
Given the above, there is no global template for good manuals. It has to be
big enough, small enough, detailed enough, organized just so, and most of
all, be appropo to all tasks.
BUT, here is a list to consider:
Introducing ...
Getting up to speed on...
Doing/Building/etc. a task
When bad software happens to good people (trouble shooting)
Apdx: UI reference
Apdx: Error codes and what they mean
INDEX
In other words, get the reader using the software as fast as possible and
then handle specific tasks. Make sure you cover the UI and trouble
shooting.
Your best bet is to consider how you learned the software and what you
needed to know, etc.
Then begin extrapolating to your larger audience (i.e., how they learn
software and what they need to know and what they are asked to do with the
software).
Good luck.
walden
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.
Check out RoboDemo for tutorials! It makes creating full-motion software
demonstrations and other onscreen support materials easy and intuitive.
Need RoboHelp? Save $100 on RoboHelp Office in May with our mail-in rebate.
Go to 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.
