Re: thoughts on documentation reuse.

[Wes Hardaker <wes@hardakers.net>]

>>>>> On Wed, 27 Mar 2002 13:46:53 +0100, Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de> said:

Wes> I thought about importing the entire DESCRIPTION clause itself,
Wes> but it just seemed that if the original author didn't realize
Wes> that his text might be used somewhere else would likely not write
Wes> it in a fashion that would be well written for somewhere else.

Juergen> Does reproducing text really help for those that do not read?

It helps those that don't follow, not those that don't read.

Juergen> If I see a data type in a program and I need to know more about it, I
Juergen> have to go to the place where it is defined to see the details.  This
Juergen> is really not that hard to do.

Yes, but people don't do it which is what the complaint was about.

Juergen> And for those who find it too hard, there are already tools
Juergen> and Web pages that generate HTML versions for MIBs where you
Juergen> just have use the mouse.

I'll take yours as a vote of 'no'

-- 
Wes Hardaker
NAI Labs
Network Associates