jekyll-now VS docco

I would recommend using jekyll now: https://github.com/barryclark/jekyll-now Just fork the repo, change config.yml and you are good to go

github (free): https://github.com/barryclark/jekyll-now

This is what my deployment looks like: https://badbird3.github.io/

I'm a complete novice and haven't got the time to get stuck into really learning html or Jekyll or whatever I should really be doing. I've forked Jekyll Now (and this page got me started with tables) and I'm perfectly happy with the simple limited stuff I can do so far. That's all I need for now.

I was doing the above at first but then when I was looking at themes for my Jekyll site I found a way easier method. You can just fork this repo on Github: (https://github.com/barryclark/jekyll-now).

barryclark/jekyll-now - Build a Jekyll blog in minutes, without touching the command line.

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

Side note - it's been a while since i've seen a Docco-style annotated-source-style documentation! http://ashkenas.com/docco/

Backbone.js was the first time i saw it, and I loved it! https://backbonejs.org/docs/backbone.html It demonstrated to me that the libraries I use are just normal code that other people write, and i myself can read it to understand a problem.

jashkenas/docco - Literate Programming can be Quick and Dirty.