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.
> So, once again, it comes down to knowing your audience and giving them
> what they need. Frequently, that will mean at least some conceptual
> framework, but not always.
I agree that there are some audiences that could care less about conceptual
information. However, that does not mean leaving it out is okay. Including
concepts does nothing to hurt the documentation. It can only help.
It also covers both types of readers. People who just want the raw procedures
will probably flip past concepts anyway and seek out the "How to ...."
sections. People who want the conceptual stuff will ignore the procedures and
flip to the "Understanding XYZ" sections. Either way, the inclusion of both is
important. It makes the document MORE accessible, not less. Thus, exclusion of
either makes for less of a document.
However, concept docs are much more difficult to write. They demand intimate
and extensive knowledge of the content. And this factor, I believe, is the
overwhelming reason documentation lacks conceptual information.
Andrew Plato
__________________________________________________
Do you Yahoo!?
Yahoo! Shopping - Send Flowers for Valentine's Day http://shopping.yahoo.com
Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l
---
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.