fix links & formatting around getting started docs

we're trying to fix the links and the generall formatting around the
getting started documentation. We achieve this mostly by inserting ref
anchors of the format:

    .. _foo-bar:

and then linking to it as:

    :ref:`foo-bar`.

That seems to be the consistently easiest way to link between documents
in sphinx/rSText.