Convert doc directives to refs

Author: sarina

source/developers/concepts/backend_layout_and_approach.rst

@@ -1,3 +1,5 @@
+.. _Backend Layout and Approach:
+
 Backend Layout and Approach
 ###########################
 

source/developers/concepts/platform_overview.rst

@@ -1,3 +1,5 @@
+.. _Platform Overview:
+
 Platform Overview
 #################
 

source/developers/how-tos/enable-javascript-upgrade-automation.rst

@@ -1,3 +1,5 @@
+.. _Enable JS Upgrade Automation:
+
 How To Enable Javascript Upgrade Automation
 ###########################################
 

source/developers/how-tos/enable-python-upgrade-automation.rst

@@ -1,3 +1,5 @@
+.. _Enable Python Upgrade Automation:
+
 How To Enable Python Upgrade Automation
 #######################################
 

source/developers/how-tos/maintain-a-repo.rst

@@ -1,3 +1,5 @@
+.. _How To Maintain a Repository:
+
 How To Maintain a Repository
 ############################
 

source/developers/how-tos/ongoing-maintainers-tasks.rst

@@ -1,3 +1,5 @@
+.. _Ongoing Maintainer's Tasks:
+
 Ongoing Maintainer's Tasks
 ##########################
 

source/developers/index.rst

@@ -11,7 +11,7 @@ Open edX Developers
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`/developers/quickstarts/first_openedx_pr`
+      * :ref:`qs Dev First PR`
       * :ref:`qs Dev Contributing`
       * :ref:`Tutor QS (Dev)`
       * :ref:`XBlock Quickstart <xblock:Build an XBlock Quick Start>`
@@ -29,15 +29,15 @@ Open edX Developers
 
       * :ref:`qs Dev Contributing`
       * :ref:`Tutor QS (Dev)`
-      * :doc:`references/running_pr_tests`
-      * :doc:`concepts/design_tokens`
+      * :ref:`Running PR Tests`
+      * :ref:`Design Tokens`
 
    .. grid-item-card:: How-tos
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`how-tos/enable-python-upgrade-automation`
-      * :doc:`how-tos/enable-javascript-upgrade-automation`
+      * :ref:`Enable Python Upgrade Automation`
+      * :ref:`Enable JS Upgrade Automation`
       +++
       .. button-ref:: how-tos/index
          :color: primary
@@ -50,10 +50,10 @@ Open edX Developers
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`concepts/platform_overview`
-      * :doc:`concepts/backend_layout_and_approach`
-      * :doc:`concepts/accessibility`
-      * :doc:`concepts/hooks_extension_framework`
+      * :ref:`Platform Overview`
+      * :ref:`Backend Layout and Approach`
+      * :ref:`Dev Accessibility Concepts`
+      * :ref:`Hooks Extension Framework`
       * :ref:`Tutor Concept (Dev)`
       * :ref:`XBlock Concepts <xblock:XBlock Concepts>`
       +++
@@ -68,12 +68,12 @@ Open edX Developers
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`references/running_pr_tests`
-      * :doc:`references/developer_guide/index`
+      * :ref:`Running PR Tests`
+      * :ref:`Open edX Developer's Guide`
       * :doc:`openedx-proposals:index`
       * :doc:`edx-platform:index`
       * `frontend-platform <https://openedx.github.io/frontend-platform>`_
-      * :doc:`references/aspects_home`
+      * :ref:`Aspects Home`
       * :ref:`XBlock Tutorial <xblock:Open edX XBlock Tutorial>`
       +++
       .. button-ref:: references/index
@@ -87,9 +87,10 @@ Open edX Developers
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`how-tos/maintain-a-repo`
-      * :doc:`how-tos/ongoing-maintainers-tasks`
-      * :doc:`references/tools_for_maintainers`
+      * :ref:`How To Maintain a Repository`
+      * :ref:`Ongoing Maintainer's Tasks`
+      * :ref:`Tools for Maintainers`
+      * :ref:`Maintainer's Home`
 
       +++
       .. button-ref:: maintainers_home

source/developers/maintainers_home.rst

@@ -1,4 +1,6 @@
-Maintainers Home
+.. _Maintainer's Home:
+
+Maintainer's Home
 ################
 
 .. grid:: 1 2 2 2
@@ -9,15 +11,16 @@ Maintainers Home
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`how-tos/maintain-a-repo`
-      * :doc:`how-tos/ongoing-maintainers-tasks`
+      * :ref:`How To Maintain a Repository`
+      * :ref:`Ongoing Maintainer's Tasks`
 
    .. grid-item-card:: References
       :class-card: sd-shadow-md sd-p-2
       :class-footer: sd-border-0
 
-      * :doc:`references/tools_for_maintainers`
+      * :ref:`Tools for Maintainers`
       * `Maintainers Slack Channel`_
+      * `Open edX AI Contribution Policy`_
 
    .. grid-item-card:: Process Documentation
       :class-card: sd-shadow-md sd-p-2
@@ -94,6 +97,8 @@ High Level Contribution Process
 
 .. _Maintainers Slack Channel: https://openedx.slack.com/archives/C03R320AFJP
 
+.. _Open edX AI Contribution Policy: https://github.com/openedx/.github/blob/master/AI_POLICY.md
+
 .. _Maintainers Office Hours Notes:  https://openedx.atlassian.net/wiki/spaces/COMM/pages/3603791889/Office+Hours+Notes
 
 .. _Maintainers Scrum of Scrums Notes: https://openedx.atlassian.net/wiki/spaces/COMM/pages/3507027983/Maintainers+Scrum+of+Scrums

source/developers/references/running_pr_tests.rst

@@ -1,3 +1,5 @@
+.. _Running PR Tests:
+
 Running Pull Request Tests
 ##########################
 

source/developers/references/tools_for_maintainers.rst

@@ -1,3 +1,5 @@
+.. _Tools for Maintainers:
+
 Tools for Maintainers
 #####################