From 470069cf10c3671f683b154703bd04a11eb7427a Mon Sep 17 00:00:00 2001 From: sarina Date: Thu, 18 Jan 2024 11:55:24 -0500 Subject: [PATCH] Clarify how to use :ref: vs :doc: in our templates --- source/documentors/references/doc_templates.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/documentors/references/doc_templates.rst b/source/documentors/references/doc_templates.rst index 0422555c4..3b94e915b 100644 --- a/source/documentors/references/doc_templates.rst +++ b/source/documentors/references/doc_templates.rst @@ -139,7 +139,11 @@ Copy this codeblock to start a new how-to topic. .. seealso:: - :ref:`title to link to` + # To cross-reference a label use :ref: + :ref:`reference to link to` + + # To point to another document in the docs.openedx.org filetree, use :doc: + :doc:`/relative/path/to_the_document` Add an Ordered List