release notes files refactoring

Paul W. Frields stickster at gmail.com
Thu Jan 5 23:30:54 UTC 2006


On Thu, 2006-01-05 at 12:31 -0800, Karsten Wade wrote:
> On Thu, 2006-01-05 at 11:33 -0800, Karsten Wade wrote:
> > In order to make it easier to move content to and from the Wiki, I have
> > reworked the release-notes module to match filenames 1:1 with Wiki beat
> > names.
> 
> You can look at the module directly here:
> 
> http://cvs.fedora.redhat.com/viewcvs/release-notes/?root=docs
> 
> I have completed adding the remaining languages, either copying over
> files that got directly renamed, or making new files where necessary.
> 
> Fun fun fun.

If I can make one suggestion just a little late (sorry), instead of
using &DOCID; as a monolithic entity replacing &BOOKID;, I think the
folks who commented on the new one agreed with the new usage being like:

<!ENTITY DOCNAME "name-of-doc">
<!ENTITY DOCVERSION "5">
<!ENTITY DOCDATE "2006-01-05">
<!ENTITY DOCID "&DOCNAME;-&DOCVERSION; (&DOCDATE;)">

This makes it much easier if/when we use XSL, xmlstarlet, or other
goodies to do good things in our building processes.  Since I haven't
(yet) documented the usage in the canon yet, I'm happy to fix them (or
just help if you let me know how you want to divvy).  What say you?

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
-------------- 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/20060105/bff9ea32/attachment.sig>


More information about the fedora-docs-list mailing list