RE: Futur tense use in technical documentation

Subject: RE: Futur tense use in technical documentation
From: Brian Clements <bclements -at- fpix -dot- com>
To: "'Sybille Sterk'" <sybille -at- wowfabgroovy -dot- net>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 21 Jan 2000 11:42:04 -0600

Neither. I would use active voice.

"When you click the X button the X dialog displays." (Actually, I would use
"appears" rather than "displays," but that's probably a matter of personal
preference.)

Brian

-----Original Message-----
From: Sybille Sterk [mailto:sybille -at- wowfabgroovy -dot- net]
Sent: Friday, January 21, 2000 4:46 AM
To: TECHWR-L
Subject: Futur tense use in technical documentation


Dear all,

We have a dispute at work. So far I have avoided the future tense wherever
possible, because from what I gathered it is not used in technical
documentation as it expresses a certain amount of doubt like it is
expressed in "may" or "might". Now, obviously this is grammatically
incorrect as my proof-reader, i.e. my boss (who, by the way is no technical
author) pointed out.

An example to make clear what I mean:

"When you click the X button the X dialog is displayed" (this is what I
normally write)
"When you click the X button the X dialog will be displayed" (this is what
my boss wants me to write)

What tense would you use?

Thanks,

Sybille


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sybille Sterk
Technical Author and Translator (German)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Email: sybille -at- wowfabgroovy -dot- net
Web Site: www.wowfabgroovy.net
ICQ: #26779340


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sponsored by Weisner Associates Inc., Online Information Services
Training & consulting for RoboHELP, Dreamweaver, HTML, and HTML-Based Help.
More info at http://www.weisner.com/train/ or mailto:training -at- weisner -dot- com -dot-

Sponsored by Rose Hill, Your Business and Career Coach.
"Assume Success! Live Your Passion!" Get the gist at
www.coachrose.com then call 503.629.4804 for details!

---
You are currently subscribed to techwr-l as: bclements -at- FPIX -dot- COM
To unsubscribe send a blank email to leave-techwr-l-9753F -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.




Previous by Author: RE: Best Documentation
Next by Author: re: futur tense use in technical documentation
Previous by Thread: RE: Futur tense use in technical documentation
Next by Thread: RE: Futur tense use in technical documentation


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


Sponsored Ads