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

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

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

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

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