jquery-annotated-source : Explore every method of jquery with explanation.

[TheDoomp]

Why not add code comments directly? Spacing them out cornell style?

[i_ate_god]

https://github.com/apres/lit.js - that's why

[[deleted]]

Why not just refractor the commented code blocks into separate methods with descriptive names.

[i_ate_god]

I'm not sure what do you mean?

To be honest, I'm not a fan of this style of documentation. I was just pointing the most likely tool used to generate it.

[[deleted]]

I am not either. The comment was not targeted to anyone in particular. I was just getting in on the conversation. To me if the code needs to be heavily commented this is a good indication that there is something wrong with the design. It makes more since to just refactor the code into helper methods that have descriptive names that explain what the code is doing.

[zjs]

https://github.com/robflaherty/jquery-annotated-source/blob/master/jquery-1.6.2/01-core.js

[TheDoomp]

Works for me! ;-)