As someone posted in the open discussion, there is always a possibility to make a taglib documentation.
1. There is a taglib-doc.dtd (example: in jakarta-taglibs/src/taglib). With this definition you develop your taglibrary.
2. You transform this taglib-doc file later with the help of XSL to the normal taglib format for use in the webapp. There are some stylesheets, depending on the JSP version you use.... read more
You know, you give taglibs away to a JSP programmer. And you put in his hands
a paper which explains, what this taglib does. With the standard documentation
tools i have seen (or with my scripts) i was only able to give him a
paper which explains the tags superficially. Mostly the attributes
are self-describing, but if he wants to know more, you have to write it
somewhere.
No one wants to or can maintain a well written taglib documentation. ... read more