RE: Overuse of gerunds in headings

Subject: RE: Overuse of gerunds in headings
From: "Joe Malin" <jmalin -at- tuvox -dot- com>
To: "William Turner" <wturner -at- force10networks -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 4 Apr 2006 16:58:31 -0700

I only use gerunds for the headings of procedures.

For conceptual information, I use "About <x>", as in "About Conversation
tags". For "containers" (usually chapters or topics that contain more
detailed sections), I use "Working with <x>". For reference information,
I use "<x>: Reference".

For context-sensitive help, I use the context name:
* name of dialog box
* name of wizard:name of page
* name of window
* name of tool/tag/identifier

Just a thought.


Joe Malin
Technical Writer
(408)625-1623
jmalin -at- tuvox -dot- com
www.tuvox.com
The views expressed in this document are those of the sender, and do not
necessarily reflect those of TuVox, Inc.

-----Original Message-----
From: techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf
Of William Turner
Sent: Tuesday, April 04, 2006 3:33 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Overuse of gerunds in headings

Whirlers,

I have worked in several Pubs departments where the standard heading
style was defined as requiring gerunds. That works fine for me when the
subject is Installing, Configuring, Restoring...stuff like that.

However, for an introductory chapter or section, am I breaking a
well-established standard by calling it, for example, "Introduction
to..." or "Overview of..."? I usually see, in similar situations, that
the author uses "Understanding ..." in order to conform to gerund
orthodoxy. For some unknown reason, that "Understanding ..." bugs me.

-- Will
~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that
easy. Watch the demo at
http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as jmalin -at- tuvox -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/jmalin%40tuvox.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: RE: I've landed
Next by Author: RE: Overuse of gerunds in headings
Previous by Thread: Re: Overuse of gerunds in headings
Next by Thread: RE: Overuse of gerunds in headings


What this post helpful? Share it with friends and colleagues:


Sponsored Ads