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.
> 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.
Making the introductory phrase a complete grammatical sentence makes it longer and thus more expensive to translate. If your translators can't translate an English infinitive phrase into the target language in a way that's clear, it's time to get some real translators.
> By starting with a infinitive phrase, every subsequent step is
> grammatically part of a potentially very long serial sentence.
Theoretically, that may be true, but it's of no consequence in practice because the introductory phrase can be omitted without making any of the steps incomplete sentences. Let's assume your style calls for no introduction at all or, for that matter, for an introduction that's a complete sentence:
1. Carefully examine the shipping container for damage.
2. Remove the Whizbang and its power supply from the container.
3. Connect the power supply to the power jack on the left rear of the Whizbang.
Now imagine your new tech pubs manager tells you to start each procedure with an infinitive phrase. What changes would you need to make to the steps if they were preceded by "To install your Whizbang:"? None.
> Just sayin'
Richard G. Combs
Senior Technical Writer
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom
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. http://www.doctohelp.com
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-