Properly handle revisions with / in them

This is pretty embarassing as all full reference names have slashes in
them
Improve documentation

- Add a README.md
- Add more comments to config.coffee.example