Re: introducing steps

Subject: Re: introducing steps
From: Phil Stokes <philstokes03 -at- googlemail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 18 Oct 2011 22:46:31 +0700

I think this is over-analysing. It makes perfect sense from a language teachers point of view (or even from the POV of a language learner using technical docs for study material - yes, I've done that!).

However, users bring their own needs to a document, and if they're looking at a doc to find out how to do something, the niceties of infinitives, gerunds, verbiage and other minor structural alternatives are not going to get in the way of the reader finding the content they came looking for.


On Tue, Oct 18, 2011 at 6:28 AM, Peter Sturgeon<prsturgeon -at- bell -dot- net> wrote:

This thread ignores translation. Making the introductory phrase a complete

grammatical sentence makes it easier for translators and non-native speakers
of English to understand the procedure.

By starting with a infinitive phrase, every subsequent step is
grammatically part of a potentially very long serial sentence.

By starting with a complete grammatical sentence, each step acts as an
independent sentence.


Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


introducing steps: From: Becca
RE: introducing steps: From: Peter Sturgeon

Previous by Author: Re: STC certification program
Next by Author: Re: introducing steps
Previous by Thread: RE: introducing steps
Next by Thread: RE: introducing steps

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

Sponsored Ads