Documentation Pass

[ciaranra]

Need to make sure all the code is documented and both the Python and Rust code properly documented (beyond basic API documentation... see #83) including examples and explanations.