Improve documentation
One-sentence description and why
Improve documentation so that we:
- Have something to show on docs pages.
- Have (tested) examples for relevant functions (doctests)
- Provide better reference to our newbies and "future generations".