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


------
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------




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

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.


Follow-Ups:

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