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".

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information