Clean up documentation

The information currently in the readme should go into docstrings, that then generate the API reference.
Library structure can go into a static document or a contributing guide, if required.

The autoapi formatting is still quite broken and needs some attention.