RE: Bad Documentation and Linux

Subject: RE: Bad Documentation and Linux
From: "Richard L Hamilton" <dick -at- rlhamilton -dot- net>
To: "'TECHWR-L'" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 7 Dec 2009 11:24:25 -0700


> From Jon Leer:
>
> The deal is that many developers don't see the point of having a
> non-developer document what they do. Yes, they will add
> comments to the
> code... And that really is all the documentation that is
> necessary (from
> their viewpoint).
>
I agree, though I would argue the best understand documentation and will
work with technical writers. In fact, if I were hiring programmers, I'd
ask some questions to determine their attitude towards writers and
documentation.

Richard Hamilton
---------------------------------
XML Press
XML for Technical Communicators
http://xmlpress.net
(970) 231-3624


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

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive. http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
RE: Bad Documentation and Linux: From: Jon Leer

Previous by Author: RE: Bad Documentation and Linux
Next by Author: Was: ISO better tools - Now Feedback
Previous by Thread: RE: Bad Documentation and Linux
Next by Thread: Re: Bad Documentation and Linux


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


Sponsored Ads