TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> > rare. I had always thought using and learning (quickly) about the
> item you were documenting was the best, nay, only way to
effectively
> communicate the
> > subject in a way that is understandable to any target audience.
When I'm writing user documentation about something very complex,
especialy if I'm in a rush, I'll take the material from the SME and
put it in the documentation (with language tweaking). However, I'll
do so only after actualy trying the instructions to verify that the
results I'm supposed to get are the ones that I DO get. If I do,
great...if not, I'll find out why, fix the described process, and
then let the SME know the difference. Sometimes, the remark I'll get
back is "S**t...I thought they fixed that..."
Let's them know that what they thought was the way it worked wasn't
reality. They usualy appreciate that.
=====
John Posada, Senior Technical Writer
"How to be happy in life: Never impose your beliefs
on anyone else and never fry bacon in the nude."
-- Anon mailto:john -at- tdandw -dot- com, 732-259-2874
__________________________________________________
Do You Yahoo!?
Yahoo! Auctions - buy the things you want at great prices http://auctions.yahoo.com/
*** 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
Sponsored by Information Mapping, Inc., a professional services firm
specializing in Knowledge Management and e-content solutions. See http://www.infomap.com or 800-463-6627 for more about our solutions.
---
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.
