Re: Usage of Verbs in Online Help Table of Contents

Subject: Re: Usage of Verbs in Online Help Table of Contents
From: "Bonnie Granat" <bgranat -at- editors-writers -dot- info>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 20 Mar 2002 21:10:28 -0500




Is there some compelling reason to do so? I have
> recently created a Table of contents that has both
> books and topics in the "-ing" form of the verb. Am I
> doing something wrong, or generally unaccepted?
>

Microsoft used to title procedural topics "To change ..." or "To rename...".
Lately, they've dropped the "To".

That earlier form and the current form without the "to" helps users quickly
distinguish procedures from concept topics. If you want to follow Microsoft
style, I'd recommend their style manual, Microsoft Manual of Style for
Technical Publications, Second Edition. They are working on a third as we
speak.


Bonnie Granat
http://www.editors-writers.info





^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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

Check out the TECHWR-L Site redesign!
http://www.raycomm.com/techwhirl/

---
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.


References:
Usage of Verbs in Online Help Table of Contents: From: Alan Alda

Previous by Author: Re: on technical writing
Next by Author: Re: Gerunds Always in Headings for Online Help?
Previous by Thread: Usage of Verbs in Online Help Table of Contents
Next by Thread: RE: El Dorado Hills Tech Writers


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


Sponsored Ads