Are there any plans on introducing something similar to Javadocs in Dojo (or does something like this already exist)? It could serve as the basis for the API documentation.
Example...
/**
* Class description here.
* @author: foo
*/
dojo.declare("my.classes.bar", my.classes.foo, {
/** This is some data. */
someData: [1, 2, 3, 4],
/**
* Constructor description here.
* @param node: A DOM node.
* @param args: Arguments to mixin with this class.
*/
