Re: Concepts (was Technical Writing Tests)

Subject: Re: Concepts (was Technical Writing Tests)
From: Jan Henning <henning -at- r-l -dot- de>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 14 Feb 2003 17:17:02 +0100

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.

I can think of several disadvantages of including unneeded conceptual information:

- It takes time, pushing back the release date.

- It costs more money.

- It makes the documentation less accessible for those who do not want/need concepts. (wheat/chaff problem)

This does not, of course, mean that concepts should be omitted where they might be needed. But when audience analysis shows that they are not required, IMHO they should be omitted to make better documentation - because documentation does not exist in a vacuum but is a tool for the reader.

Jan Henning

Jan Henning
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 700 0200 0700, Fax: +49 8179 9307-12
E-Mail: henning -at- r-l -dot- de, Web:


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

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 for more resources and info.


Re: Concepts (was Technical Writing Tests): From: Andrew Plato

Previous by Author: Re: Concepts (was Technical Writing Tests)
Next by Author: Re: "Platform" vs. "OS"?
Previous by Thread: Re: Concepts (was Technical Writing Tests)
Next by Thread: RE: Concepts (was Technical Writing Tests)

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

Sponsored Ads