doc: fix incorrect format for :ref:
doc: fix option list

There should be at least two spaces between the option and the description.
doc: release announcements as toctree
doc: display platform-specific quickstart notes as toc
Merge pull request #199 from AlexanderS/fix-doc

Fix doc errors