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: Grammar Q From:Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Wed, 23 Jan 2008 07:19:32 +1100
louise -dot- r -dot- stevanovic -at- transport -dot- qld -dot- gov -dot- au wrote:
>
> I'd be interested to hear how those of you who never use 'you' would reword
> sentences that provide options, reminders or information rather than
> imperatives, such as the following:
>
I believe in the use of "you." The main way to rewrite
these sentences involves the passive voice, and I think
that "you" is by far the better option. However, as an
exercise for the alert reader, here are my rewrites :->
>
> You will be prompted to update the document history whenever you
> save the document as a new version.
>
When the document is saved as a new version, a prompt
requests that the document history be updated.
> The IMD toolbar is displayed in the bottom left of the screen. You
> can move it anywhere on the screen.
>
The toolbar can be moved anywhere on the screen.
> If you insert captions, remember to update the lists under the
> Figures and Tables headings.
>
When inserting captions, ...
> The last paragraph mark contains formatting for that document, so
> if you copy it, it can overwrite the formatting in the document
> you paste into.
>
Because the last paragraph mark contains formatting
for that document, copying the mark can overwrite
the formatting in the document in which it is
pasted.
-- Janice
***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-