Update documentation to match reality, fixes #5.
Merge pull request #20 from square/puls/update-documentation

Update documentation to match reality