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

www.flirthermography.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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! http://www.webworks.com/techwr-l


---
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
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

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