Improve documentation

[A-CGray]

Description of feature

Potential solution

• fix some docstrings (e.g. math rendering etc.) and sphinx linking to other functions
• add a bit more text to explain the examples, or make them more uniform
• move some of the installation notes from the README to the RST files