Re: Adding boilerplate errata/CVS instructions

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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


[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux