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.
Subject:Re: Gerunds Always in Headings for Online Help? From:"Bonnie Granat" <bgranat -at- editors-writers -dot- info> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 27 Mar 2002 18:56:48 -0500
> Questions:
> 1. Has anybody else seen how this use of gerunds might get in the way of
the
> user finding what they are looking for?
> 2. Has anybody else come up with another scheme for naming the heading so
> that gerunds can be eliminated or used less often?
> 3. If the answer to #2 is Yes, would you please share?
>
> I'd appreciate any comments on this issue.
>
When I worked at Parametric Technology, we saw that train before it arrived.
We designed a Help system to prevent the problem altogether.
The Help system had the following topic types, and the Help system itself
was organized according to subject/module:
- Concepts
- Procedures
- Reference
- Example
- (It's been more than a year, and I can't remember the last topic type)
Using this arrangement, you could have seventeen "Creating a New
<Whatever>", but because they'd all appear in different "books" or main
units of the Help system, they cause no confusion.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at http://www.ehelp.com/techwr
---
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.