TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
For procedures, simplicity rules, and a definition of from which point of view the reader should understand clockwise / counter-clockwise is likely to confuse the reader more than it would enlighten him. This is due to the fact that the user does not spend any time thinking on "Now, when I pick up the camera I must turn the focus ring clockwise for far focus and counter-clockwise for near focus". Our user studies show that the user merely picks up the camera and turns the focus ring while looking at the screen.
But the "and" is obviously unnecessary and the sentence could be even more simplified:
"Turn the focus ring clockwise / counter-clockwise to adjust focus"
"Turn the focus ring to adjust focus"
Technical Documentation Manager
From: HBacheler -at- aol -dot- com [mailto:HBacheler -at- aol -dot- com]
Sent: Wed 2005-08-24 18:42
To: Broberg, Mats; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Syntax preferences?
No ambiguity there!
And our discussion helped all of us.
Assume the 'reader' of our documentation has some smarts.
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.