Syntax preferences

Subject: Syntax preferences
From: "Broberg, Mats" <mabr -at- flir -dot- se>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 23 Aug 2005 08:33:45 +0200

Dear all,

In a one-sentence step in a procedure, do you prefer to start the
sentence with the result, or with the action to achieve the result? I
need to decide on a general policy in our documentation.

In books about technical writing, I come across both recommendations.
The jury still seems to be out on this.

An example:

- To adjust focus, turn the ring.

- Turn the ring to adjust focus

Best regards,
Mats Broberg
Technica Documentation Manager


Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today!

You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.


Previous by Author: RE: Simplified Technical English Training
Next by Author: RE: Syntax preferences?
Previous by Thread: RE: How does one "sign-off" on a 200 page document?
Next by Thread: Re: Syntax preferences

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

Sponsored Ads