RE: ISO 26514 draft ready for comment [long]

Subject: RE: ISO 26514 draft ready for comment [long]
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 28 Jul 2006 10:33:05 -0600

Bonnie Granat wrote:

> I am sitting here imagining what a good technical writer
> could do to *this* document to make it usable.

I think I'd start by searching for the word "shall." Somewhere following
each occurrence, I'd begin typing, "(But, it depends ..."

The problem with this doc -- the problem with virually everything ever
created by people of a certain bureaucratic mindset -- is that it tries
to create rules to be mindlessly obeyed where what's called for are
principles to be intelligently applied.

"It's my opinion and it's very true."


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom


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: Asking for help in designing a new document
Next by Author: RE: ISO 26514 draft ready for comment [long]
Previous by Thread: RE: Re: ISO 26514 draft ready for comment [long]
Next by Thread: Re: ISO 26514 draft ready for comment [long]

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

Sponsored Ads