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:Grammar Question: Ensure or Make From:"William J. Hartzer" <William -dot- Hartzer -at- EMC2-TAO -dot- FISC -dot- COM> Date:Thu, 26 Oct 1995 17:21:55 -0600
Hi!
It seems that I came across a little dispute about some grammar in some
documentation I am working on for a Windows software product. One developer
says that I should use the term 'MAKE SURE' and another insists that I use
'ENSURE' in the following sentence. And still another insists that there is a
specific type of writing style that must be used when documenting a Windows PC
software product.
Should I use:
"Make sure that you are off-line prior to selecting this option."
OR
"Ensure that you are off-line prior to selecting this option."
Also, is there such a thing as a writing style that must be used whenever
Windows PC software products are being documented? This developer claims
that this Windows PC software product writing style is MUCH different than the
writing style I'm supposed to use when documenting an IBM Mainframe product
or even a Macintosh software product.
What do you think? Let me know via private e-mail about the grammar question,
but I think the 'writing style' topic is appropriate for posting to the whole
list.
Regards,
Bill Hartzer
Technical Writer
Fischer International Systems Corporation
Naples, Florida USA
<William -dot- Hartzer -at- EMC2-TAO -dot- FISC -dot- COM>
"The Mac is NOT a toy."
