Re: Grammar Q

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

-- 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.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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

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 for more resources and info.

Re: Grammar Q: From: louise . r . stevanovic

Previous by Author: Re: User documentation - drawings or photographs?
Next by Author: Re: Grammar Q
Previous by Thread: RE: Grammar Q
Next by Thread: RE: Grammar Q

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

Sponsored Ads