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