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:"Sarah Kampman" <skampman -at- acornsys -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 27 Mar 2002 16:50:32 -0600
> 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?
My answer to #2 is yes, even though I use the simple infinitive instead of
the "-ing" form in the titles. I like to keep the how-to's grouped by the
basic task that needs to be accomplished. Here's how I handle it:
__Instead of:________________
How do I...
Add this
Add that
Add the other
Edit this
...
__I combine the verbs:_______
How do I...
Add...
This
That
The other
Edit...
Delete...
Etc...
I also provide slight redundancy in providing a Concepts section, broken
down by noun, that includes both conceptual and how-to info. For example:
Concepts
This
About this
This settings
This error messages
Adding this
Editing this
Deleting this
That
The other
Hope that provides an alternate way of handling things!
-Sarah Kampman
skampman -at- acornsys -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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.