How to use jekyll to write a documentation of a project?

Jekyll is very blog-oriented. It can be used to generate static html pages, but it isn't ideal for documenting a software project (unless you intend to document it with a blog).

If your project is hosted on github, you will probably be better off by using github's wiki, which is fairly advanced now.

If you still want to generate documentation automatically, there are better solutions out there - pydoc is one, but there are others, like Sphinx, or the newest arrival, Dexy.

Now in 2014 there are some templates, I'm looking at

• http://bruth.github.io/jekyll-docs-template/
  • example http://modeltree.harvest.io/ref/lookup-syntax.html
• https://github.com/clojurewerkz/docslate
  • example http://clojuremongodb.info/
  • http://blog.clojurewerkz.org/blog/2013/06/15/how-we-document-our-projects-with-clojurewerkz-docslate/
• https://github.com/untyped/jekyll-docs
  • example ?? https://mynaweb.com/help/quick-start

2015 adding:

• https://github.com/tomjohnson1492/jekyll-doc from the answer of from Tom.

I think there should be others, but don't know.

I'm developing a jekyll theme for tech docs here: https://github.com/tomjohnson1492/documentation-theme-jekyll.