per Sphinx docs: "Using ref is advised over standard reStructuredText
links to sections because it works across files, when section headings
are changed, and for all builders that support cross-references.