Fix broken :ref: links

openedx · Jan 22, 2025 · 506f750 · 506f750
1 parent 1510626
commit 506f750
Show file tree

Hide file tree

Showing 44 changed files with 113 additions and 102 deletions.
diff --git a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst
@@ -1,4 +1,4 @@
-.. _What is Course Dashboard:
+.. _What is the Course Dashboard:
 
 What is the Course Dashboard?
 #############################

diff --git a/source/educators/concepts/open_edx_platform/what_is_lms.rst b/source/educators/concepts/open_edx_platform/what_is_lms.rst
@@ -26,4 +26,4 @@ Studio.
 
  :ref:`What is Studio` (concept)
 
- :ref:`What is Course Dashboard` (concept)
+ :ref:`What is the Course Dashboard` (concept)
diff --git a/source/educators/concepts/open_edx_platform/what_is_profile_page.rst b/source/educators/concepts/open_edx_platform/what_is_profile_page.rst
@@ -44,10 +44,10 @@ You can share either a limited profile or a full profile.
 .. seealso::
  :class: dropdown
 
- :doc:`Add or Update a Limited Profile <../../how-tos/add_update_limited_profile>` (how-to)
+ :ref:`Add or Update a Limited Profile` (how-to)
 
- :doc:`Add or Update a Full Profile <../../how-tos/add_update_full_profile>` (how-to)
+ :ref:`Add or Update a Full Profile` (how-to)
 
- :doc:`Add Links to Your Personal Social Media Accounts <../../how-tos/add_links_to_social_media_accounts>` (how-to)
+ :ref:`Add Links to Your Personal Social Media Accounts` (how-to)
 
- :doc:`View Another Learner’s Profile <../../how-tos/view_another_learners_profile>` (how-to)
+ :ref:`View Another Learner's Profile` (how-to)
diff --git a/source/educators/concepts/open_edx_platform/what_is_programs_page.rst b/source/educators/concepts/open_edx_platform/what_is_programs_page.rst
@@ -34,7 +34,7 @@ On the **Programs** page, you can perform the following actions.
 .. seealso::
  :class: dropdown
 
- :ref:`What is Course Dashboard` (concept)
+ :ref:`What is the Course Dashboard` (concept)
 
  :ref:`What is LMS` (concept)
 

diff --git a/source/educators/concepts/releasing-course/beta_testing.rst b/source/educators/concepts/releasing-course/beta_testing.rst
@@ -192,5 +192,5 @@ unit<Publish a Unit>`.
 .. seealso::
  :class: dropdown
 
- :ref:`Add_Beta_Testers` (how-to)
+ :ref:`Add Beta Testers to a Course` (how-to)
 
diff --git a/source/educators/how-tos/add_course_creators.rst b/source/educators/how-tos/add_course_creators.rst
@@ -38,9 +38,9 @@ For a step-by-step to grant staff permissions to courses, check out this video:
 .. seealso::
  :class: dropdown
 
- :ref:`Add Beta Testers to a CourseAdd Beta Testers to a CourseAdd Beta Testers to a Course` (how-to)
+ :ref:`Add Beta Testers to a Course` (how-to)
 
  :ref:`Add Course Staff` (how-to)
 
- :ref:`Planning Course Staff` (reference)
+ :ref:`Planning Course Staff  <Course_Staffing>` (reference)
 
diff --git a/source/educators/how-tos/add_links_to_social_media_accounts.rst b/source/educators/how-tos/add_links_to_social_media_accounts.rst
@@ -1,4 +1,5 @@
-################################################
+.. _Add Links to Your Personal Social Media Accounts:
+
 Add Links to Your Personal Social Media Accounts
 ################################################
 

diff --git a/source/educators/how-tos/add_multiple_choice.rst b/source/educators/how-tos/add_multiple_choice.rst
@@ -41,13 +41,15 @@ This video explains how to add a multiple choice (also known as "single-select")
 
  :ref:`Overview` (concept)
 
- :ref:`Multiple-Choice Problem Type` (how-to)
+ :ref:`Multiple Choice` (how-to)
 
- :ref:`Add a Single Select Problem` (how-to)
+ :ref:`Single Select` (how-to)
 
- :ref:`Award Partial Credit in a Multiple Choice Problem` (how-to)
+ :ref:`Single Select and Numerical Input` (how-to)
 
- :ref:`Edit Single Select Problems using the Advanced Editor` (how-to)
+ :ref:`Awarding Partial Credit in a Multiple Choice Problem` (how-to)
+
+ :ref:`Editing Single Select Problems using the Advanced Editor` (how-to)
 
  :ref:`Add a Dropdown Problem` (how-to)
 

diff --git a/source/educators/how-tos/add_update_full_profile.rst b/source/educators/how-tos/add_update_full_profile.rst
@@ -1,4 +1,5 @@
-############################
+.. _Add or Update a Full Profile:
+
 Add or Update a Full Profile
 ############################
 

diff --git a/source/educators/how-tos/add_update_limited_profile.rst b/source/educators/how-tos/add_update_limited_profile.rst
@@ -1,4 +1,5 @@
-###############################
+.. _Add or Update a Limited Profile:
+
 Add or Update a Limited Profile
 ###############################
 

diff --git a/source/educators/how-tos/add_video.rst b/source/educators/how-tos/add_video.rst
@@ -27,7 +27,7 @@ This name appears as a heading above the video in the LMS, and it identifies the
 
  :ref:`Course About Video Guidelines` (reference)
 
- :ref:`Troubleshooting Video Problems` (reference)
+ :ref:`Troubleshoot Videos` (reference)
 
 
 

diff --git a/source/educators/how-tos/allow_anonymous_discussions.rst b/source/educators/how-tos/allow_anonymous_discussions.rst
@@ -1,4 +1,5 @@
-#########################################
+.. _Enable/Disable Anonymous Discussion Posts:
+
 Enable/Disable Anonymous Discussion Posts
 #########################################
 
@@ -70,15 +71,15 @@ Enable/Disable "Allow Anonymous Discussion Posts to Peers"
 .. seealso::
  :class: dropdown
 
- :ref:`About Course Discussions` (concept)
+ :ref:`Discussions` (concept)
 
- :ref:`Running Course Discussions` (concept)
+ :ref:`Running_discussions` (concept)
 
- :ref:`Moderating Discussions` (concept)
+ :ref:`Moderating_discussions` (concept)
 
  :ref:`Guidance for Discussion Moderators` (concept)
 
- :ref:`Assigning Discussion Moderation Roles` (how-to)
+ :ref:`Assigning_discussion_roles` (how-to)
 
  :ref:`Configuring Open edX Discussions` (how-to)
 
@@ -90,9 +91,9 @@ Enable/Disable "Allow Anonymous Discussion Posts to Peers"
 
  :ref:` Setting up Discussions in Courses with Cohorts` (how-to)
 
- :ref:`A Learner's View of the Discussion` (reference)
+ :ref:`A Students View of the Discussion` (reference)
 
- :ref:`About Divided Discussion Topics` (concept)
+ :ref:`About Divided Discussions` (concept)
 
  :ref:`Setting Up Divided Discussions` (how-to)
 

diff --git a/source/educators/how-tos/communication/setup_cohorted_discussions.rst b/source/educators/how-tos/communication/setup_cohorted_discussions.rst
@@ -23,15 +23,15 @@ Divided Discussion Topics` and :ref:`Moderating_discussions`.
 .. seealso::
  :class: dropdown
 
- :ref:`About Course Discussions` (concept)
+ :ref:`Discussions` (concept)
 
- :ref:`Running Course Discussions` (concept)
+ :ref:`Running_discussions` (concept)
 
- :ref:`Moderating Discussions` (concept)
+ :ref:`Moderating_discussions` (concept)
 
  :ref:`Guidance for Discussion Moderators` (concept)
 
- :ref:`Assigning Discussion Moderation Roles` (how-to)
+ :ref:`Assigning_discussion_roles` (how-to)
 
  :ref:`Configuring Open edX Discussions` (how-to)
 
@@ -43,9 +43,9 @@ Divided Discussion Topics` and :ref:`Moderating_discussions`.
 
  :ref:`Administer Discussions` (how-to)
 
- :ref:`A Learner's View of the Discussion` (reference)
+ :ref:`A Students View of the Discussion` (reference)
 
- :ref:`About Divided Discussion Topics` (concept)
+ :ref:`About Divided Discussions` (concept)
 
  :ref:`Setting Up Divided Discussions` (how-to)
 

diff --git a/source/educators/how-tos/connect_teams_content_groups.rst b/source/educators/how-tos/connect_teams_content_groups.rst
@@ -26,15 +26,15 @@ Connecting Teams to Content Groups
 .. seealso::
  :class: dropdown
 
- :ref:`Teams Overview` (concept)
+ :ref:`Teams Overview  <CA_Teams_Overview>` (concept)
 
  :ref:`Teams Configuration Options` (reference)
 
  :ref:`Managing Teams via CSV Upload` (reference)
 
- :ref:`Managing Team Discussions` (concept)
+ :ref:`Managing Team Discussions <Teams Discussions>` (concept)
 
- :ref:`The Learner's Experience of Teams` (concept)
+ :ref:`The Learner's Experience of Teams <CA Learner Experience of Teams>` (concept)
 
  :ref:`Enable and Configure Teams` (how-to)
 
diff --git a/...ators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst b/...ators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst
@@ -41,21 +41,19 @@ taxonomy. Here's how to do that:
    #. In Google Sheets, use File > Download > Comma Separated Values (.csv).
    #. In Numbers, use File > Export To > CSV… and use the default options.
 
-#. Import the taxonomy following `How-To: Import and export a taxonomy
-   <https://openedx.atlassian.net/wiki/spaces/OEPM/pages/4154490883/How-to+Import+and+export+a+taxonomy>`_
-   guide.
+#. Import the taxonomy following the :ref:`import-export-taxonomy`  guide.
 
 
 .. seealso::
  :class: dropdown
 
- :ref:`Build a taxonomy using a template` (how-to)
+ :ref:`build-taxonomy-using-template` (how-to)
 
- :ref:`Import and export a taxonomy` (how-to)
+ :ref:`import-export-taxonomy` (how-to)
 
  :ref:`Update/Re-import a taxonomy` (how-to)
 
- :ref:`Why does each tag need an ID when importing a taxonomy?` (concept)
+ :ref:`tag-ids-for-taxonomy-import` (concept)
 
  :ref:`Manage Permissions on a Taxonomy` (how-to)
 

diff --git a/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst b/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst
@@ -84,15 +84,15 @@ Deleting Tags from the Course Outline Page
 .. seealso::
  :class: dropdown
 
- :ref:`Build a taxonomy using a template` (how-to)
+ :ref:`build-taxonomy-using-template` (how-to)
 
- :ref:`Create a flat taxonomy by uploading a CSV` (how-to) 
+ :ref:`create-flat-taxonomy` (how-to) 
 
- :ref:`Import and export a taxonomy` (how-to)
+ :ref:`import-export-taxonomy` (how-to)
 
  :ref:`Update/Re-import a taxonomy` (how-to)
 
- :ref:`Why does each tag need an ID when importing a taxonomy?` (concept)
+ :ref:`tag-ids-for-taxonomy-import` (concept)
 
  :ref:`Manage Permissions on a Taxonomy` (how-to)
 

diff --git a/source/educators/how-tos/content-tagging-how-tos/export_tag_data_from_course.rst b/source/educators/how-tos/content-tagging-how-tos/export_tag_data_from_course.rst
@@ -17,18 +17,18 @@ Export a CSV file that reports on which tags have been added to which parts of t
 .. seealso::
  :class: dropdown
 
- :ref:`Build a taxonomy using a template` (how-to)
+ :ref:`build-taxonomy-using-template` (how-to)
 
- :ref:`Import and export a taxonomy` (how-to)
+ :ref:`import-export-taxonomy` (how-to)
 
  :ref:`Update/Re-import a taxonomy` (how-to)
 
- :ref:`Why does each tag need an ID when importing a taxonomy?` (concept)
+ :ref:`tag-ids-for-taxonomy-import` (concept)
 
  :ref:`Manage Permissions on a Taxonomy` (how-to)
 
  :ref:`add-tags-to-a-course` (how-to)
 
  :ref:`Add and delete tags on course content` (how-to)
 
- :ref:`Create a flat taxonomy by uploading a CSV` (how-to)
+ :ref:`create-flat-taxonomy` (how-to)
diff --git a/source/educators/how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst b/source/educators/how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst
@@ -65,20 +65,20 @@ do that.
 .. seealso::
  :class: dropdown
 
- :ref:`Build a taxonomy using a template` (how-to)
+ :ref:`build-taxonomy-using-template` (how-to)
 
- :ref:`Import and export a taxonomy` (how-to)
+ :ref:`import-export-taxonomy` (how-to)
 
  :ref:`Update/Re-import a taxonomy` (how-to)
 
- :ref:`Why does each tag need an ID when importing a taxonomy?` (concept)
+ :ref:`tag-ids-for-taxonomy-import` (concept)
 
  :ref:`Manage Permissions on a Taxonomy` (how-to)
 
  :ref:`add-tags-to-a-course` (how-to)
 
  :ref:`Add and delete tags on course content` (how-to)
 
- :ref:`Create a flat taxonomy by uploading a CSV` (how-to)
+ :ref:`create-flat-taxonomy` (how-to)
 
 
diff --git a/source/educators/how-tos/course_development/hide_subsections.rst b/source/educators/how-tos/course_development/hide_subsections.rst
@@ -119,13 +119,13 @@ end date" message under the subsection's display name.
 
  :ref:`Course Outline` (concept)
 
- :ref:`Creating a New Course in Studio` (how-to)
+ :ref:`Creating a New Course in Studio <Creating a New Course>` (how-to)
 
- :ref:`Create a New Course Screen` (quick start)
+ :ref:`Quick Start Build a Course` (quick start)
 
  :ref:`Create the Course About Page` (how-to)
 
- :ref:`Understanding a Course Outline` (reference)
+ :ref:`Understanding a Course Outline <Understanding Your Course Outline>` (reference)
 
  :ref:`Add Content in the Course Outline` (reference)
 

diff --git a/source/educators/how-tos/course_development/set_course_highlights.rst b/source/educators/how-tos/course_development/set_course_highlights.rst
@@ -80,5 +80,5 @@ Enable Highlight Emails
 .. seealso::
  :class: dropdown
 
- :ref:`Juniper release notes: Educator Experiences` (reference)
+ :ref:`juniper_educator` (reference)
 
diff --git a/source/educators/how-tos/course_development/set_subsection_problem_date.rst b/source/educators/how-tos/course_development/set_subsection_problem_date.rst
@@ -119,5 +119,5 @@ To change the results visibility for your subsection, follow these steps.
 .. seealso::
  :class: dropdown
 
- :ref:`Create an Open Response Assessment Assignment` (how-to)
+ :ref:`Create an Open Response Assessment Assignment <PA Create an ORA Assignment>` (how-to)
 
diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst
@@ -41,13 +41,13 @@ You are then taken to the empty Outline page in Studio.
 
  :ref:`Course Outline` (concept)
 
- :ref:`Creating a New Course in Studio` (how-to)
+ :ref:`Creating a New Course in Studio <Creating a New Course>` (how-to)
 
- :ref:`Hiding a Subsection from Learners` (how-to)
+ :ref:`hiding a subsection from learners <Hide a Subsection from Students>` (how-to)
 
  :ref:`Create the Course About Page` (how-to)
 
- :ref:`Understanding a Course Outline` (reference)
+ :ref:`Understanding a Course Outline <Understanding Your Course Outline>` (reference)
 
  :ref:`Add Content in the Course Outline` (reference)
 

diff --git a/source/educators/how-tos/create_course_about_page.rst b/source/educators/how-tos/create_course_about_page.rst
@@ -17,13 +17,13 @@ Watch this video to understand how to create a course description:
 
  :ref:`Course Outline` (concept)
 
- :ref:`Creating a New Course in Studio` (how-to)
+ :ref:`Creating a New Course in Studio <Creating a New Course>` (how-to)
 
- :ref:`Create a New Course Screen` (quick start)
+ :ref:`Quick Start Build a Course` (quick start)
 
- :ref:`Hiding a Subsection from Learners` (how-to)
+ :ref:`hiding a subsection from learners <Hide a Subsection from Students>` (how-to)
 
- :ref:`Understanding a Course Outline` (reference)
+ :ref:`Understanding a Course Outline <Understanding Your Course Outline>` (reference)
 
  :ref:`Add Content in the Course Outline` (reference)
 

diff --git a/source/educators/how-tos/data/manage_course_grades.rst b/source/educators/how-tos/data/manage_course_grades.rst
@@ -917,6 +917,6 @@ viewer.
 
  :ref:`Understanding the Progress Page` (reference)
 
- :ref:`Interpreting the Grade Report` (reference)
+ :ref:`Interpret the Grade Report` (reference)
 
- :ref:`Interpreting the Problem Grade Report` (reference)
+ :ref:`Interpret the Problem Grade Report` (reference)
diff --git a/source/educators/how-tos/embed_iframe_text_editor.rst b/source/educators/how-tos/embed_iframe_text_editor.rst
@@ -1,3 +1,5 @@
+.. _Embed an iframe in the Text Editor:
+
 Embed an iframe in the Text Editor
 ##################################
 

diff --git a/source/educators/how-tos/publish_units.rst b/source/educators/how-tos/publish_units.rst
@@ -16,5 +16,5 @@ After you have added content, you must publish it to make it available to learne
 .. seealso::
  :class: dropdown
 
- :ref:`Controlling Content Visibility and Access` (reference)
+ :ref:`Controlling Content Visibility` (reference)
 
diff --git a/source/educators/how-tos/releasing-course/add_beta_testers.rst b/source/educators/how-tos/releasing-course/add_beta_testers.rst
@@ -1,4 +1,4 @@
-.. _Add_Beta_Testers:
+.. _Add Beta Testers to a Course:
 
 ############################
 Add Beta Testers to a Course
Original file line number	Diff line number	Diff line change
Expand Up		@@ -26,4 +26,4 @@ Studio.

		:ref:`What is Studio` (concept)

		:ref:`What is Course Dashboard` (concept)
		:ref:`What is the Course Dashboard` (concept)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -27,7 +27,7 @@ This name appears as a heading above the video in the LMS, and it identifies the

		:ref:`Course About Video Guidelines` (reference)

		:ref:`Troubleshooting Video Problems` (reference)
		:ref:`Troubleshoot Videos` (reference)



Expand Down