RE: Syntax preferences

["Nuckols, Kenneth M" <Kenneth -dot- Nuckols -at- mybrighthouse -dot- com>]

Mats Broberg asked...

> 
> 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
> 

My personal preference would be the second option.  It's more direct,
active, and succinct.

Of course if Herman Melville were a Technical Writer he would say:

- "Turn the ring to adjust the focus as if combinedly possessed by all
the angels that fell from heaven."

Is it Friday yet?

CONFIDENTIALITY NOTICE: This e-mail may contain information that is privileged, confidential or otherwise protected from disclosure. If you are not the intended recipient of this e-mail, please notify the sender immediately by return e-mail, purge it and do not disseminate or copy it. 

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

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.