RE: Best Documentation

Subject: RE: Best Documentation
From: "Anthony Markatos" <tonymar -at- hotmail -dot- com>
To: kay -dot- robart -at- integratedconcepts -dot- com, techwr-l -at- lists -dot- raycomm -dot- com
Date: Wed, 09 Feb 2000 09:09:07 PST

Tony Markatos responds to Kay Roberts (see below):

SME's can create very good technical communications. I usually work as a Systems Analyst. When I do TW-type work, it is to:

* Create especially difficult documentation. For example clear, concise software requirements specs for complex software systems.

* Fix-up botched end-user documentation. I'm am not going to say who, on more than one occasion, botched-up these jobs; I would be 'flammed' from hear to eternity!

Tony Markatos
(tonymar -at- hotmail -dot- com)

Kay Roberts said:

....we [Technical Writers] frequently do not consider subject matter experts like programmers and engineers capable of writing good documentation........many do not have the writing skills to write comprehensibly to the reader. They are not taught to express themselves for any audience other than other subject matter experts, they cannot adapt the vocabulary if that is needed....[continues on with 900 other reasons why SMEs can not write].
Get Your Private, Free Email at

Previous by Author: RE: Re[2]: Best Documentation
Next by Author: RE: Adverbs, good or evil?
Previous by Thread: RE: Re[2]: Best Documentation
Next by Thread: Re: Best Documentation

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

Sponsored Ads