Re: Past Tents

Subject: Re: Past Tents
From: "Delaney, Misti" <ncr02!ncr02!mdelaney -at- UCS01 -dot- ATTMAIL -dot- COM>
Date: Wed, 26 Jul 1995 14:56:00 -0500

Scott asks:
How far do you go with the idea of keeping to the present tense when
editing somebody
else's documentation.

Well, first I must confess that I'm a real stickler. I figure it's one of
the things that makes me a good editor. That said, though, it *is* a
preference, so I comment on the cover page that it's more readable to use
present tense -- then I make a tense mark nest to any future tense
construction, should the writer want to take my advice. On second review,
unless the author made some of the changes, I ignore future tense
constructions and simply look for consistency.

Any opinions on when it's ok. to use "you" in documentation?

I use it whenever possible because i think, again, that it makes the
document more readable. The reader is usually also the "doer" and it saves
a mental step if the document makes that assumption.

ncr02!mdelaney -at- attmail -dot- com

Previous by Author: From the annals of "If I don't laugh, I'll cry"
Next by Author: FW: STYLE:HELP
Previous by Thread: Re: Past Tents
Next by Thread: Re: Past Tents

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

Sponsored Ads