Re: thoughts on documentation reuse.

[Wes Hardaker <wes@hardakers.net>]

>>>>> On Fri, 29 Mar 2002 13:11:49 -0800, "Durham, David" <david.durham@intel.com> said:

David> I would liken this to reading a book and having a glossary for
David> acronyms.

That would be another way to do it.  Or to include the expanded
typedefs at the top of a MIB.

David> So even from a documentation standpoint, I could see the need
David> for a "glossary" of reused data in an appendix somewhere, but I
David> wouldn't want to see that extra text repeated over and over
David> again everywhere in my document... I don't view that as being
David> particularly readable for anyone.

I actually agree.  I'd read the "shorter" version myself.  I was
merely attempting to find a solution for the people that complain
about following references.

-- 
Wes Hardaker
NAI Labs
Network Associates