Documentation #20
Description
We clearly need more and better documentation. Is the README format enough for 1.0 or should we add a full site using something like Sphinx (i.e. similar to the Spray docs)?
This issue should probably be split into more fine-grained issues on what to document and how to write documentation.