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.
For some time now, my company has been producing installation manuals to
guide the user through each step of the installation process for our
software.
These have generally taken the form:
{graphic}
Type this.
Click that.
Click Next.
for each step.
However, our current software is customised for each client, so for most
steps the instructions reads something like:
"Click Next to accept the default setting and proceed to the next step."
If they choose not to accept the default, there's rarely a way of
describing the other options to them without providing a whole load of
highly technical detail that they don't need.
For instance, for one of the installation steps, the associated graphic
has the text:
"Please enter the socket number on which the Authorisation Service will
listen for authorisations. Usually, this will be 2050."
What is there left for the technical writer to add? A discussion about
sockets? An exhortation to click Next?
Our installation guides can run to 30/40 pages, with most pages
containing just the graphic and one or two lines of text. I imagine this
must be totally tedious for the user, and I doubt if it's of much use
either. However, our managers don't want to do away with the
Installation Guides altogether.
Does anyone have any comments/suggestions on how to improve our
installation guides? Any ideas gratefully received.
Thanks in advance.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Forwarded anonymously on request. If you want the
original poster to see your response, you must reply
to the TECHWR-L list. All direct replies to this
message are automatically discarded. Contact Eric
ejray -at- raycomm -dot- com with questions.