RE: Usage of perfect in TW

Subject: RE: Usage of perfect in TW
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Ihor Rozdil" <badspike -at- mail -dot- ru>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 7 May 2008 15:02:06 -0600

Ihor Rozdil wrote:

> Most best practices recommend to use simple present while writing
guides.
> Simple past is also welcome. What about present perfect, has anyone
seen
> some recommedations on that? Please vote for one of the following
variants
> of the same sentense:
> 1. Aftet the installation has completed, restart your computer.
> 2. After the installation is completed, restart your computer.
> 3. After the installation completed, restart your computer.
>
> Thanks.

I think option 2 is better than option 1, but I don't see any good
reason for using passive voice.

Option 3 is grammatically incorrect (it may be a typo), but could be
made tolerable by changing one letter:

3. After the installation completes, restart your computer.

But I vote for Sean Brierly's version, which is much better than any of
the above:

> After the installation finishes, restart your computer.

IMHO, etc.

Richard


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------





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

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-

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%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.


References:
Usage of perfect in TW: From: Ihor Rozdil

Previous by Author: RE: Definition of Tech Writer, was STC is broken
Next by Author: RE: Can I Get Your Input Please
Previous by Thread: Re: Usage of perfect in TW
Next by Thread: Re: Usage of perfect in TW


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


Sponsored Ads