Continue improving the 0.6 docs

make an anchor:
```

.. _foo

Foo
===

Some text
```
then reference it:
```
Some text is at :ref:`foo`
```