Point to upgrading :doc: not :ref:
Fix wording
Don't use headings for the link text

Mostly they don't read well in the context of the sentence and have
wrong capitalization