Finish README

I've added the details as we agreed.
Merge pull request #2 from thomaspichon/readme-edits

Finish README