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.
This seems to be not working in your example output (I mean the indentation of this line is lost -> not anymore in `with` context)