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:Using a gerund phrase for procedure topic titles From:"Chuck Martin" <twriter -at- sonic -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 28 Dec 2001 13:05:10 -0800
Hey all, I've been away from reading and contributing awhile, but now... :)
For many years, I've used as the title for procedural topics (in online
Help) the gerund phase: Creating a New Document, Changing the Modem
Settings, and so on. But I see in Office 2000, Microsoft seems to have
changed this (at least in Word). Now I see the simple form of the verb:
Create a New Document, Change the Modem Settings, etc.
So I'm wondering: is one or the other better for users to find and
understand? Does anyone know of any research in this area?
One though that comes to my mind, a mind that's always thinking of keeping
online files as compact as possible, is that the simple form is typically a
character or 3 shorter--which results in a byte or 3 less for each topic. It
may not be much, but in the online world, every little bit can help--and
when a Help system has hundreds of topics, this can really add up too. So
cuould this be nothing more than a way for MS to squish the Help file a bit
more?
--
--
"I don't entirely understand it but it is true: Highly skilled
carpenters don't get insulted when told they are not architects,
but highly skilled programmers do get insulted when told
they are not UI designers."
- anonymous programmer quoted in "GUI Bloopers"
Chuck Martin
User Assistance & Experience Engineer
twriter "at" sonic "dot" net www.writeforyou.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Be a published author! iUniverse gives you: a high-quality paperback, a
custom cover design, and distribution to 25,000 retailers. And it's
affordable. Join our almost 10,000 published authors today. http://www.iuniverse.com/media/techwr
Sponsored by eHelp Corporation, makers of RoboHelp - the industry standard
in Help authoring. Download a trial version today or get special savings when
you buy the RoboHelp 2002 Holiday Edition. Visit 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.