Add documentation to API docs

Pull request #22 adds documentations about the use of this library into README.md, but we should have it also in our API documentation since that gets linked in the package meta data. Either we should duplicate it there or remove it from README.md and point to the API docs.