ISO 26514 draft ready for comment [long]

Combs, Richard richard.combs at Polycom.com
Fri Jul 28 10:33:05 MDT 2006


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







More information about the TECHWR-L mailing list