Proposal for document entities

Stuart Ellis stuart at elsn.org
Sat Nov 19 11:10:44 UTC 2005


On Fri, 2005-11-18 at 15:34 -0500, Paul W. Frields wrote:
> Currently, our documents have entities like this (please pardon the MUA
> mangling):
> 
> <!ENTITY % FEDORA-ENTITIES-EN SYSTEM
> "../docs-common/common/fedora-entities-en.ent">
> %FEDORA-ENTITIES-EN;
> <!ENTITY BOOKID "foo-tutorial-0.15 (2005-01-01)"> <!-- change version of
> manual and date here -->
> 
> 
> I would like to see this instead as a standard:
> 
> <!ENTITY BOOKNAME "foo-tutorial">
> <!ENTITY BOOKVERSION "0.15"> <!-- change version number here -->
> <!ENTITY BOOKDATE "2005-01-01"> <!-- change revision date here -->
> <!ENTITY BOOKID "&BOOKNAME;-&BOOKVERSION; (&BOOKDATE;)">
> <!ENTITY BUG-NUM "000000"> <!-- only used while in draft -->

Another +1.

I'd prefer "DOC*", over "BOOK*" for these, just because documents may
all not be Guides, and most of the end-products are on-line, rather than
specifically for printing.

-- 

Stuart Ellis

stuart at elsn.org

Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

GPG key ID: 7098ABEA
GPG key fingerprint: 68B0 E291 FB19 C845 E60E  9569 292E E365 7098 ABEA
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20051119/7d041ccb/attachment.sig>


More information about the fedora-docs-list mailing list