Re: New TECHWR-L Poll Question

Subject: Re: New TECHWR-L Poll Question
From: Fred Sampson <wfreds -at- cruzio -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 28 Nov 2001 07:42:51 -0800

I don't know if notes/cautions/warnings help readers or not. I do know that they soothe the consciences of developers and product managers who release poorly designed, inadequately tested, highly complex software, and who depend on the documentation to cover their shortcomings.

But no, I'm not bitter.

-Fred


Do notes, cautions, and warnings in documentation help
readers notice and heed specific information?

* Yes, they generally help readers
* No, they generally do not help readers
* Depends entirely on the context and situation
* Other/none of the above


Fred Sampson
Technical Writer
fred -at- fredsampson -dot- com
831-728-1339


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

Collect Royalties, Not Rejection Letters! Tell us your rejection story when you submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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



Follow-Ups:

Previous by Author: RE/re/re/re Banned words
Next by Author: Fw: cats on leashes (was Re: Technical review of documentation?)
Previous by Thread: RE: New TECHWR-L Poll Question
Next by Thread: Re: New TECHWR-L Poll Question--amen Fred


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


Sponsored Ads