Documentation generation is something that should be included in any software project.
AsciiDoc allows you to create documentation in text similair to markdown. You can afterwards generate HTML and PDF's.
A simple but efficient example is the following:
http://www.methods.co.nz/asciidoc/article.txt for the text version and for the html one http://www.methods.co.nz/asciidoc/article.html