Update documentation

[HJLebbink]

Update the documentation:

1. Add detailed inline documentation for all public (API-facing) functions.
2. Write a concise README.md explaining the overall structure and basic usage of the API.
3. Include a (partial) list of currently unsupported S3 features.
4. Add a walkthrough with both a simple example and a more advanced use case.