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: Beginning topic titles with "How to..." From:Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Wed, 20 Feb 2008 04:08:59 +1100
Deborah Slutzky wrote:
> Hello All,
> I need some opinions. Just wondering how folks feel about beginning
> topic titles with "How to..." I'm used to beginning them with a gerund,
> but the shop that I am now working for has an assorted bag of formats
> and I run into this once in a while. Personally, I don't care for it
> because I think the entire Help is a How to.....but I'd like some
> thoughts from others.
>
I prefer "To" to "How to" because I think that "How" is
just another word to have to skip in the title to get to
the actual distinguishing verb and text.
As for Geoff's suggestion of changing to a gerund, we use
gerunds in heads for conceptual sections and infinitives
for procedure heads.
-- Janice
***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-