On 2/15/06, Sean Schofield <[EMAIL PROTECTED]> wrote: > I have a few other ideas about the revised docs. I'm not sure syntax > and usage are that helpful. We now have a pretty good subsistute for > syntax in the form of the TLD docs. Maybe we could have a "See TLD > Documentation" under the syntax section for each component? (ex. > http://myfaces.apache.org/tomahawk/tlddoc/index.html)
I disagree with the removal of the usage section. The usage section shows how to use the component in context which is not always obvious. I don't see a problem with making it optional for trivial components, however. I'm also not thrilled with the removal of the syntax section, but I agree that the TLD docs could be a substitute. My preference would be to see the syntax section generated from the same source as the TLD docs, but I'm not volunteering to do the work at this time. :) At minimum, the link to the TLD section should point directly to the TLD document for the component in question rather than to the TLD index. Also, before the syntax section is removed, the TLD docs must be updated to contain the same information. That's not currently the case (I used dataList as a test of this theory). -Mike
