I think it may be beneficial to extend the clay dtd to add extra elements for documentation. Just like the component element in the faces-config.xml has a description sub-element. I say this only because I am trying to document all of my clay config definitions and it would really be nice if I could write a maven plugin to just rip through all my config files and generate the html documentation. That way I can keep everything in one place.
I was thinking corresponding descriptions for the component, symbols, and attributes. The clay parser would ignore the descriptions for memory sake, but a maven plugin could generate from them. What do you think?
