Docco 0.6.0 Released. New design and Literate (any language) support | Hacker News Reader

Docco 0.6.0 Released. New design and Literate (any language) support

jashkenas.github.com

40 pointsjashkenas9 comments

Haven't proofed 'em for glitches yet ... but if you want more examples, I've updated some docs:

Backbone.js: http://backbonejs.org/docs/backbone.html

CoffeeScript: http://coffeescript.org/documentation/docs/scope.html

Underscore.js: http://underscorejs.org/docs/underscore.html

I'm hoping that the new `--layout` flag might be the start of a wider variety of these "themes", contributed by y'all. Even if you're not comfortable with CoffeeScript, and just want to contribute a bit of HTML and CSS, it should be pretty easy to dive right in.

Don't want to look mean, but the new layout its "cheaper" than the previous one. Probably I'm just to the old one.

_A parte_: could you please make the links stand out more?

This does feel like more of a "traditional" layout. I think I am a bit partial to the old side-by-side format myself.

Me too. I found it easier to keep track of the code logic or the "story" in the documentation without them interfering with each other, but easy enough to jump from one to the other when wanted.

I kinda do want to be mean. This hurts my head, I already miss the side-by-side, where I could see the contiguous code.

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.

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.

Why do the code text boxes have a scroll bar when the code does not leave the text box bounds? Doesn't look very good.

Thanks. Should be fixed now.

Reply on news.ycombinator.com