John Resig annotates original jQuery source code
Very neat content, but does it have to be formatted like this? I respect that it preserves the original file, but it makes it very difficult to read. Comments added to the source code would serve much better for the purposes of understanding the code.This tool makes it impossible to read the annotation and the source code at the same time. Clicking on 'set' for example, about 20-30 lines in, lets you read the annotation, but not the function. You have to hide the annotation to read the code.Wouldn't inline/multiline comments be so much better than this?Edit: Citation/example: http://i.imgur.com/CHOFGML.png