Add in documentation for the public API

[JamieMair]

Once the main API is sorted, we should start adding some documentation on how to use the package. All examples should be backed by unit tests to make sure they don't become stale.

TODO:

• Make sure to document how the named access and direct ID accessing works - IDs start from 0.