What does HackerNews think of docco?

Literate Programming can be Quick and Dirty.

Language: HTML

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

> 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

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://github.com/visionmedia/express