Hi all,
I just checked in some files that implement the "news" and
"state" proposal in the HOWTO-RELEASE document, and I'd like to propose
moving them to the site. The relevant pieces are:
- /src/doc/taglibs_doc.dtd
My attempt to represent our documentation format as a DTD. I
added element for displaying news and the "state" of each tag
library.
- /src/doc/stylesheets/taglibs.xsl
Updates with the new news and state elements
- /src/doc/index.xml
Updated with news, including the renaming of JDBC taglib and
the retirement of the SQL taglib. Also added descriptions
and state for each taglib.
- src/doc/project.xml
Renamed JDBC to DBTags and added a special section for UNSUPPORTED
tags.
I also updated the DBTags and the SQL documentation with news sections.
I'm not all that happy with the formatting of the Taglib description
section, but we can play with the stylesheet now or later.
Also, as the news sections get longer, they will probably have to be moved
into a separate XML file. The way the transformations are designed right
now makes that difficult to do for individual taglibs, so we may have to
do some light refactoring later.
You may be wondering why all the current tags are in the "Pre-Release" or
"Unsupported" state. Technically taglibs do not move to the beta or
released state until they have a formal binary release (daily builds do
not count). We should be able to perform binary builds, now that we have
a news section to track our progress. I hope to formally release DBTags
next week.
I am +1 for moving out a new version of the homepage that includes news
and tag descriptions. I am also +1 for updating the SQL documentation and
moving DBTags to its new home. :)
- Morgan
