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

closes #6838. 
closes #3104 
Breakout "options" section for docs, heavily using info already in ``basics.rst``. Expands examples, and turns ``describe_options`` into a table.
I would move this right after ``basics`` (before indexing)