RE: you or he/it

Subject: RE: you or he/it
From: <Brian -dot- Henderson -at- mitchell1 -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 22 Jun 2006 09:04:49 -0700

There's one thing I'd like to add to this discussion that hasn't been addressed directly, and that is that the TYPE of documentation plays a big part in language usage. The company I work for produces automotive repair information. Hardcore tech writing for hardcore technicians, who get very annoyed by superfluous "chit-chat". In fact, they often claim to only read the tables and refer to the illustrations. For that audience, you really want to cut to the chase. I would re-write Sean's example as:

Use color picker (J-440p) to set background color for pages.

I have to add though, the Asian OEM manuals are a good example of what has been covered already. While their automotive tech writing is fairly concise, they tend to be -- by western standards -- somewhat "conversational".

Brian Henderson
Data Composition
Mitchell Repair Information Co.
San Diego, CA
www.mitchell1.com


-----Original Message----- From: Sean Hower

For example:

You can use the color picker to set the background of your pages.

can be rewritten as

Use the color picker to set the background color for pages.

_
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -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.


Previous by Author: RE: XyWrite (Was Re: John Sladek (was PK Dick))
Next by Author: Re: "taboo engineering techniques" (RE: Modularization of Documentation)
Previous by Thread: RE: you or he/it
Next by Thread: RE: you or he/it


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


Sponsored Ads