We've started to document javascript using YUIDOC syntax. 
You should find some example here and there. 

We'll try to document at lest new functions.
I can help if you need to generate the jsdoc.