4 ms·

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

40 points by jashkenas 14y ago

jashkenas 14y ago
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 http://backbonejs.org/docs/backbone.html CoffeeScript: http://coffeescript.org/documentation/docs/scope.html http://coffeescript.org/documentation/docs/scope.html Underscore.js: http://underscorejs.org/docs/underscore.html 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.
Jacob4u2 14y ago
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/parallel https://github.com/jashkenas/docco/tree/master/resources/par..., though it doesn't look like that is the same theme as the backbone docs.
- jashkenas 14y ago
  This is the one you're looking for: https://github.com/jashkenas/docco/tree/master/resources/linear 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.
lqdc13 14y ago
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.
- jashkenas 14y ago
  Thanks. Should be fixed now.
yuchi 14y ago
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?
- stock_toaster 14y ago
  This does feel like more of a "traditional" layout. I think I am a bit partial to the old side-by-side format myself.
  - epidemian 14y ago
    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.
- Helianthus 14y ago
  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.

40 points by jashkenas 14y ago

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 http://backbonejs.org/docs/backbone.html CoffeeScript: http://coffeescript.org/documentation/docs/scope.html http://coffeescript.org/documentation/docs/scope.html Underscore.js: http://underscorejs.org/docs/underscore.html 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.

Jacob4u2 14y ago

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/parallel https://github.com/jashkenas/docco/tree/master/resources/par..., though it doesn't look like that is the same theme as the backbone docs.

jashkenas 14y ago
This is the one you're looking for: https://github.com/jashkenas/docco/tree/master/resources/linear 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.

lqdc13 14y ago

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.

jashkenas 14y ago
Thanks. Should be fixed now.

yuchi 14y ago

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?

stock_toaster 14y ago
This does feel like more of a "traditional" layout. I think I am a bit partial to the old side-by-side format myself.
- epidemian 14y ago
  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.
Helianthus 14y ago
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.