[mark_story]

That idea kind of reminds me of the annotated source used for backbone. http://backbonejs.org/docs/backbone.html

[vineet]

I love the philosophy behind the annotated source for backbone. But, there seems to be something more going on with commenting - especially given that the content of the backbonejs.org homepage is different from that of the annotated source.

I guess the comments are meeting the needs of two different audiences (those looking at just the api and those looking ay the code).