Re: Benchmarking Technical Documentation

["Kelly Williamson" <kwcwtech -at- iwaynet -dot- net>]

Kent wrote:
> Seems a bit an irrelevant discussion since it's the subject matter
> experts' responsibility to verify adequacy and completeness of content
> and it's the tech writer's responsibility to ensure readability, i.e.
create
> the best format.

Where'd you get that idea? Seems a rather broad statement to make. I can say
for sure that that's not the way it works everywhere. Maybe in a rocket
science type environment, but in my environment (documenting Web
applications in which I was involved from the ground floor), the programmer
didn't ever even look at my document/help, let alone ensure its adequacy and
completeness. That was my job.

It seems the type you're referring to are the type so often complained about
on this list--the "pretty formatters" with no technical know-how.

/Kelly Williamson
 Columbus, OH



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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

Learn about tools and technologies for user assistance developers at
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com


---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit 
http://www.raycomm.com/techwhirl/ for more resources and info.