Sentence structure

Subject: Sentence structure
From: Karen Mayer <Karen_Mayer -dot- TOUCH_TECHNOLOGY -at- NOTES -dot- COMPUSERVE -dot- COM>
Date: Wed, 21 Jun 1995 12:43:01 EDT

When you are giving an instruction in your documentation, do you first
give the instruction, then identify the need or condition, or do you
identify the need or condition first and follow it with the instruction?

For example, which would you more likely write:

A. To drive a car, first go to the department of transportation and apply
for a driver's license.
B. Go to the department of transportation and apply for a driver's
license before driving a car.

C. To access the reports database, exit the personnel screen and return
to the main menu.
D. Exit the personnel screen and return to the main menu before accessing
the reports database.

--km


Previous by Author: Re: Documenting running water
Next by Author: Re: Message from Internet
Previous by Thread: Re: Humor, Dr. Suess
Next by Thread: Re: Sentence structure


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


Sponsored Ads