Docs/Pre v1 propose refactor

[jlnav]

Addresses #1012

There's a couple ideas I'd like to address, primarily for beginning users:

• Make small, simple code samples viewable as soon as possible
• Flexibility is important, but shouldn't supersede ease-of-use or ease-of-initial-understanding

• Is it possible to avoid this common docs pitfall: "if doing this, then this, if doing that, do that, if doing this with some of that do part of this and that."
• Show one simple way of doing something first, then alternatives come later

• Move, or remove, any "justification for existence"
• Maybe pick a new theme? It's a one-line change: https://sphinx-themes.org/