Nitpick; do you think we should start having comments like this:
/**
 * Some explanation of the function
 * @param some parameter to the function
 */

I believe that would be the format JSDoc would be expecting, though I don't know if we intend to use that. 
http://en.wikipedia.org/wiki/JSDoc