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: Usage of perfect in TW From:Michael West <WestM -at- conwag -dot- com> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Thu, 8 May 2008 17:20:40 +1000
> From: Ihor Rozdil
> 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.
I prefer simple present ("is complete"), but more important, I think, is
whether your instruction is sufficiently clear. How do I know when the
installation is complete? Will there be a message? If so, then perhaps it
would be helpful to mention that fact. If not, then, again, how will I
know when it is complete? (Can the resart be automated, by the way? That
would make the instuction superfluous.)
Your third option is grammatically unnacceptable in this context. The
first two are okay, but could be better.
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-