Re: Cataloging LDP White Paper: Document Reorganization

["Andy Oram" <andyo@oreilly.com>]

That's a well-thought-out summary; you've remembered a lot of things that
technically sophisticated folks tend not to remember when they put together
documentation. I responded particularly to the Basic/Backgrounder section.
One note from my experience: I try to get the Key Concepts right (or as an
editor, push authors to get it right) and find I rarely need a Key Terms
section because people know the terms once they've finished Key Concepts.
But it doesn't hurt to leave a placeholder for Key Terms because it may be
useful in many documents.

While it may not affect this classification endeavor, we have to remember
that documents tend to grow both in size and in scope. They also spawn
related documents, which can be added to the
Related sections.

Andy


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