On Tue, 2004-11-30 at 21:44 -0500, Tammy Fox wrote:
I saw your RFE. I think it is a great idea, like the name "About
this
Document," and like the name about-doc-en.xml as the filename.
However, I think it would be better as a separate sect1 either at the
beginning or the end of the document. Tips are supposed to be shorter
pieces of information called out to help the reader accomplish a task.
I've seen many other documents with an About this Document section,
and they have always been separate sections.
Having a separate section also allows us to have a common place for
the "Acknowledgements" and "Revision History" sections under this
sect1 as sect2s.
Thoughts?
My brain is unfreezing a bit here ... I recall that in fact Mark Johnson
did a draft that included an Introduction with much of such information
of ... let's see ...
http://people.redhat.com/mjohnson/docs/fedora/docbook-emacs-
quickstart/index.html#about
We could include the CVS bit as a section within this section.
- Karsten
--
Karsten Wade, RHCE, Sr. Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41