Adding a cross-reference to a subheading or anchor in another page

Question

How to insert a cross-reference in a reST/Sphinx page to either a sub-header or anchor in another page in the same documentation set?

Answer 1

Example:

Hey, read the :ref:`Installation:Homebrew` section.

where Homebrew is a section inside a different document named Installation.rst.

This uses the autosection feature, so will need to edit config.py with the following:

extensions = [
    'sphinx.ext.autosectionlabel'
]
autosectionlabel_prefix_document = True