RE: Documentation Metrics

["Craig M. Buchek" <cbuchek@linuxgruven.com>]

"David C. Merrill, Ph.D." wrote:

>>> 2. Audience Technical Sophistication
>>> - novice
>>> - beginner
>>> - intermediate
>>> - advanced

>> A more interesting way, I think, to ask this, might be as a maximum
>> and minimum. On a scale of 10, this docs deals with topics up to
>> level 8 and provides background down to 3. If you don't already
>> know level 2, read other things first.

> So we would identify the amount of experience required to
> understand it, and the amount of experience at which it is
> no longer informative? This is an interesting approach.

Yes.  That's what I was trying to get at when I suggested a range.  I've
seen a couple publishing companies use such a range on the back covers of
their books to indicate the technical level of the intended audience.

Craig M. Buchek
Documentation Manager
Linuxgruven


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org