docco

I think Docco was when that approach acquired some kind of popularity? So 2010 or so[1]. Of course Haskell has had its “literate format” since forever (ETA: the Haskell 1.2 report[2], dated March 1992, has a description in an appendix), and it became mildly popular for Haskell blogging when blogs caught on, but its name was always accompanied by a side note that in Haskell you don’t really need to reorder things (kind of true). [1] https://github.com/jashkenas/docco/commit/9b666b77c476fd76b9... [2] http://haskell.org/definition/haskell-report-1.2.ps.gz

i have seen those in annotated javascript documentation. but it was the other way around. (comment on the left, and code on the right). they all seem to use docco[0] with the option to display comment in "parallel". the author of docco used it in their library underscore[1]. [0]: https://github.com/jashkenas/docco [1]: https://underscorejs.org/docs/underscore-esm.html

I like this idea. It could take literate programming [1] to the next level. Existing tools like docco [2] can output beautiful documentation [3] with comments set alongside code. The language/editor described above would allow us to input code in the same side-by-side format. [1]: https://en.m.wikipedia.org/wiki/Literate_programming [2]: https://github.com/jashkenas/docco [3]: https://underscorejs.org/docs/underscore.html

> Literate programming… didn't catch on I would argue literate programming is experiencing a renaissance, thanks to docco: https://github.com/jashkenas/docco

This is the one you're looking for: https://github.com/jashkenas/docco/tree/master/resources/lin... ... just a template that gets fed the list of parsed and printed sections, and a bit of CSS. Nothing too fancy.

The concept of themes looks interesting. For anyone looking to see what a theme looks like, take a look at https://github.com/jashkenas/docco/tree/master/resources/par..., though it doesn't look like that is the same theme as the backbone docs.

> The visual design and structural layout of the documentation is certainly not of Stripe's creation. That's all Jeremy Ashkenas. For those curious, he's referring to Docco: https://github.com/jashkenas/docco http://jashkenas.github.com/docco/ Which is used on the Coffeescript annotated source (amongst other places): http://coffeescript.org/documentation/docs/grammar.html

Good question, I have filed an issue against the tool used to generate the doc: https://github.com/jashkenas/docco/issues/80

Looks like Docco by Jeremy Ashkenas (CoffeeScript/BackBone.js fame) with some extra styling and a navigation bar up top. https://github.com/jashkenas/docco

This are a few of the things that I am to following : Server side: Testing: - Expresso [1]: TDD framework for node -- high speed parallel testing! - Zombie.js [2]: fast, headless full-stack testing using Node.js Tools: - load.js [3]: Lazy load your JS - npm [4] a package manager for node - JSDoc [5] Documentation tool - Docco [6] Literate documentation. - underscore [7] provides a lot of the functional programming - node-openid [8] openid. Frameworks: - Express [8] Sinatra inspired web development framework for node [1] http://visionmedia.github.com/expresso/ [2] http://zombie.labnotes.org/ [3] https://github.com/chriso/load.js [4] https://github.com/isaacs/npm [5] https://github.com/micmath/JSDoc [6] https://github.com/jashkenas/docco [7] http://documentcloud.github.com/underscore/ [8] https://github.com/havard/node-openid [9] https://g

http://github.com/jashkenas/docco http://github.com/rtomayko/rocco http://github.com/rtomayko/shocco

No, this (docco) is a separate implementation. Even the language is different - CoffeeScript vs JavaScript. Compare the source: http://github.com/jashkenas/docco/blob/master/docco.coffee http://code.google.com/p/code-illuminated/source/browse/docs...