Improve documentation somewhat and use Markdown for docco goodness.