Improve Python API documention #407
Description
The Python API documentation is minimal, lacking a lot of important detail. Many of the parameters are shared between the different formats, so hopefully we can have some sphinx/rst infrastructure for keeping the documentation for (say) samples_chunk_size in one place.