Anyone develop any tools for generating documentation for elements?

Question

Kinda like javadocs but for polymer-elements.

I get the feeling these were generated from a tool http://www.polymer-project.org/docs/elements/polymer-elements.html http://www.polymer-project.org/docs/elements/polymer-ui-elements.html

If no tools you can share specifically, maybe someone can share description of approach. XSLT?

Answer 1

We are in the process of cleaning these things up and documenting the documentation tools just in the next couple of weeks. I'm sorry that it's all a bit rough around the edges today. Having said that, here is some info:

Polymer vends a polymer-doc-viewer component that you can point to (one or more) HTML files to generate documentation from source comments. Look at the demo.html to see some possible usage.

We also have polymer-docs component which will render docs for all polymer elements that it knows about that you have installed. Here is a live version installed at gh-pages:

http://polymer.github.io/polymer-docs/components/polymer-docs/

The comment format is JSDoc-like, mostly copied from YUIDoc. The rendered output will probably get a face-lift soon, but this is one of the good parts: if we change it and then you update your copy of component, it will just work.

You can also customize or make your own polymer-doc-viewer, as the code is pretty simple. There is another component (included) called context-free-parser that actually snarfs up the documentation data into a JavaScript object (data model) so you can render it anyway you like.