DOC: closes gh6838. Breakout options.rst from basics.rst

Closes gh6838.  Breakout "options" section for docs, heavily using info already in ``basics.rst``. Expands examples, and turns ``describe_options`` into a table.