08 Mar 2010

docco

Okay, this is the project used to generate the previously linked CoffeeScript documentation. It’s a “quick-and-dirty, hundred-line-long, literate-programming-style documentation generator.” It pulls out comments, applies markdown, and then runs the code through pygments for syntax highlighting.

Beautiful.

jashkenas.github.com   08:21

Annotated CoffeeScript Grammar

I don’t believe I’ve ever seen code annotated like this before:

screen cap

It’s perfect.

The HTML is <table> based. Each segment is an anchored <tr> with the left cell holding the annotations and the right cell holding the code. I’d probably flip them around but the overall effect is wonderful.

jashkenas.github.com   07:57