Could a reStructured text/Sphinx maven tell me the correct way to code an external reference in a documentation file? In one file I found three different methods:
I had no luck searching online. If it matters, I'm adding cross-references between TableGen documents that are all in the same docs/ TableGen directory.
A link to another document with a path relative to the current document. Title is the caption of the link.
A link to another document with a path relative to the current document. The linked document’s title is used for the caption.
A link to an arbitrary URL. Please avoid for cross-references as it should change relative to where the documents are. For instance, each the documentation of each release should link to the version of its release (e.g. https://releases.llvm.org/10.0.0/tools/clang/docs/index.html), not the latest from trunk (e.g. https://clang.llvm.org/docs/index.html)
I had no luck searching online. If it matters, I’m adding cross-references between TableGen documents that are all in the same docs/ TableGen directory.
reStructured Text documentation is available at:
The :ref: role is useful as well.