Merge pull request #601 from jswope00/jswope00/educators_ux_ui

Merge new Educators UX/UI in Open edX Docs
openedx · Nov 8, 2024 · 5927bea · 5927bea
2 parents 62d6315 + 017e56c
commit 5927bea
Show file tree

Hide file tree

Showing 400 changed files with 2,668 additions and 1,696 deletions.
diff --git a/source/_images/educators_homepage/accessibility_undraw.png b/source/_images/educators_homepage/accessibility_undraw.png
diff --git a/source/_images/educators_homepage/advanced_features_undraw.png b/source/_images/educators_homepage/advanced_features_undraw.png
diff --git a/source/_images/educators_homepage/assessments_grading_undraw.png b/source/_images/educators_homepage/assessments_grading_undraw.png
diff --git a/source/_images/educators_homepage/build_course_undraw.png b/source/_images/educators_homepage/build_course_undraw.png
diff --git a/source/_images/educators_homepage/content_creation_management_undraw.png b/source/_images/educators_homepage/content_creation_management_undraw.png
diff --git a/source/_images/educators_homepage/data_analytics_undraw.png b/source/_images/educators_homepage/data_analytics_undraw.png
diff --git a/source/_images/educators_homepage/educator_undraw.png b/source/_images/educators_homepage/educator_undraw.png
diff --git a/source/_images/educators_homepage/engagement_communication_undraw.png b/source/_images/educators_homepage/engagement_communication_undraw.png
diff --git a/source/_tags/tagsindex.rst b/source/_tags/tagsindex.rst
diff --git a/source/educators/concepts/accessibility/accessibility_guidelines.rst b/source/educators/concepts/accessibility/accessibility_guidelines.rst
@@ -46,7 +46,10 @@ For more information, see the following topics.
 .. seealso::
  :class: dropdown
 
-  :ref:`Accessibility Best Practices for Course Content Development` (concept)
-  :ref:`Designing for Mobile` (concept)
-  :ref:`Supporting Learners with Diverse Needs` (concept)
-  :ref:`Accessibility Checker` (reference)
+ :ref:`Accessibility Best Practices for Course Content Development` (concept)
+
+ :ref:`Designing for Mobile` (concept)
+
+ :ref:`Supporting Learners with Diverse Needs` (concept)
+
+ :ref:`Accessibility Checker` (reference)
diff --git a/source/educators/concepts/accessibility/best_practices_course_content_dev.rst b/source/educators/concepts/accessibility/best_practices_course_content_dev.rst
@@ -1057,7 +1057,10 @@ Universal Design for Learning Resources
 .. seealso::
  :class: dropdown
 
-  :ref:`edX Accessibility Guidelines` (concept)
-  :ref:`Designing for Mobile` (concept)
-  :ref:`Supporting Learners with Diverse Needs` (concept)
-  :ref:`Accessibility Checker` (reference)
+ :ref:`edX Accessibility Guidelines` (concept)
+
+ :ref:`Designing for Mobile` (concept)
+
+ :ref:`Supporting Learners with Diverse Needs` (concept)
+
+ :ref:`Accessibility Checker` (reference)
diff --git a/source/educators/concepts/accessibility/design_for_mobile.rst b/source/educators/concepts/accessibility/design_for_mobile.rst
@@ -103,7 +103,10 @@ renders as you expect it to.
 .. seealso::
  :class: dropdown
 
-  :ref:`Accessibility Best Practices for Course Content Development` (concept)
-  :ref:`edX Accessibility Guidelines` (concept)
-  :ref:`Supporting Learners with Diverse Needs` (concept)
-  :ref:`Accessibility Checker` (reference)
+ :ref:`Accessibility Best Practices for Course Content Development` (concept)
+
+ :ref:`edX Accessibility Guidelines` (concept)
+
+ :ref:`Supporting Learners with Diverse Needs` (concept)
+
+ :ref:`Accessibility Checker` (reference)
diff --git a/source/educators/concepts/accessibility/index.rst b/source/educators/concepts/accessibility/index.rst
diff --git a/source/educators/concepts/accessibility/supporting_learners_diverse_needs.rst b/source/educators/concepts/accessibility/supporting_learners_diverse_needs.rst
@@ -88,7 +88,10 @@ when creating a course.
 .. seealso::
  :class: dropdown
 
-  :ref:`Accessibility Best Practices for Course Content Development` (concept)
-  :ref:`edX Accessibility Guidelines` (concept)
-  :ref:`Designing for Mobile` (concept)
-  :ref:`Accessibility Checker` (reference)
+ :ref:`Accessibility Best Practices for Course Content Development` (concept)
+
+ :ref:`edX Accessibility Guidelines` (concept)
+
+ :ref:`Designing for Mobile` (concept)
+
+ :ref:`Accessibility Checker` (reference)
diff --git a/source/educators/concepts/advanced_features/cohorts_overview.rst b/source/educators/concepts/advanced_features/cohorts_overview.rst
@@ -283,9 +283,14 @@ contributions remain consistent over time.
 .. seealso::
  :class: dropdown
 
-  :ref:`Manage Course Cohorts` (how-to)
-  :ref:`Create Cohort Specific Course Content` (how-to)
-  :ref:`About Divided Discussions` (concept)
-  :ref:`Managing Divided Discussion Topics` (concept)
-  :ref:`Moderating_discussions` (concept)
-  :ref:`Setting Up Divided Discussions` (how-to)
+ :ref:`Manage Course Cohorts` (how-to)
+
+ :ref:`Create Cohort Specific Course Content` (how-to)
+
+ :ref:`About Divided Discussions` (concept)
+
+ :ref:`Managing Divided Discussion Topics` (concept)
+
+ :ref:`Moderating_discussions` (concept)
+
+ :ref:`Setting Up Divided Discussions` (how-to)
diff --git a/source/educators/concepts/advanced_features/content_experiments_overview.rst b/source/educators/concepts/advanced_features/content_experiments_overview.rst
@@ -57,4 +57,4 @@ or :ref:`Set Up Group Configuration for OLX Courses`.
 
 You then select which group configuration to use when you add a content
 experiment :ref:`using Studio <Add a Content Experiment in Studio>` or
-:ref:`Add a Content Experiment in OLX`.
+:ref:`Add a Content Experiment in OLX`.
diff --git a/source/educators/concepts/advanced_features/group_configurations.rst b/source/educators/concepts/advanced_features/group_configurations.rst
@@ -28,9 +28,14 @@ group configuration that assigns your learners to four experiment groups.
 .. seealso::
  :class: dropdown
 
-  :ref:`Offering Differentiated Content` (concept)
-  :ref:`Configure Your Course for Content Experiments` (how-to)
-  :ref:`Experiment Group Configurations` (reference)
-  :ref:`Add a Content Experiment in OLX` (how-to)
-  :ref:`Set Up Group Configuration for OLX Courses` (how-to)
-  :ref:`Guidelines for Modifying Group Configurations` (concept)
+ :ref:`Offering Differentiated Content` (concept)
+
+ :ref:`Configure Your Course for Content Experiments` (how-to)
+
+ :ref:`Experiment Group Configurations` (reference)
+
+ :ref:`Add a Content Experiment in OLX` (how-to)
+
+ :ref:`Set Up Group Configuration for OLX Courses` (how-to)
+
+ :ref:`Guidelines for Modifying Group Configurations` (concept)
diff --git a/...ducators/concepts/advanced_features/guidlines_modifying_group_configuration.rst b/...ducators/concepts/advanced_features/guidlines_modifying_group_configuration.rst
@@ -53,9 +53,14 @@ group that you removed and the date on which you removed it.
 .. seealso::
  :class: dropdown
 
-  :ref:`Offering Differentiated Content` (concept)
-  :ref:`Overview of Content Experiments` (concept)
-  :ref:`Configure Your Course for Content Experiments` (how-to)
-  :ref:`Experiment Group Configurations` (reference)
-  :ref:`Add a Content Experiment in OLX` (how-to)
-  :ref:`Set Up Group Configuration for OLX Courses` (how-to)
+ :ref:`Offering Differentiated Content` (concept)
+
+ :ref:`Overview of Content Experiments` (concept)
+
+ :ref:`Configure Your Course for Content Experiments` (how-to)
+
+ :ref:`Experiment Group Configurations` (reference)
+
+ :ref:`Add a Content Experiment in OLX` (how-to)
+
+ :ref:`Set Up Group Configuration for OLX Courses` (how-to)
diff --git a/source/educators/concepts/advanced_features/index.rst b/source/educators/concepts/advanced_features/index.rst
diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst
@@ -89,4 +89,4 @@ then transferred automatically to the grade book in the external LMS. For more
 information, see :ref:`Grading Remote Content`.
 
 To obtain learner engagement and performance data, you use the features
-available in the external LMS.
+available in the external LMS.
diff --git a/source/educators/concepts/advanced_features/managing_teams_discussions.rst b/source/educators/concepts/advanced_features/managing_teams_discussions.rst
@@ -54,8 +54,12 @@ administrators have a **Staff** label.
 .. seealso::
  :class: dropdown
 
-  :ref:`Teams Overview <CA_Teams_Overview>` (concept)
-  :ref:`Enable and Configure Teams` (how-to)
-  :ref:`Teams Configuration Options` (reference)
-  :ref:`The Learner's Experience of Teams <CA Learner Experience of Teams>` (concept)
-  :ref:`Managing Teams via CSV Upload` (reference)
+ :ref:`Teams Overview <CA_Teams_Overview>` (concept)
+
+ :ref:`Enable and Configure Teams` (how-to)
+
+ :ref:`Teams Configuration Options` (reference)
+
+ :ref:`The Learner's Experience of Teams <CA Learner Experience of Teams>` (concept)
+
+ :ref:`Managing Teams via CSV Upload` (reference)
diff --git a/source/educators/concepts/advanced_features/offering_differentiated_content.rst b/source/educators/concepts/advanced_features/offering_differentiated_content.rst
@@ -70,5 +70,5 @@ For information about creating differentiated content using cohorts, see
 .. seealso::
  :class: dropdown
 
-  :ref:`Enrollment Track Specific Courseware Overview` (how-to)
+ :ref:`Enrollment Track Specific Courseware Overview` (how-to)
 
diff --git a/source/educators/concepts/advanced_features/teams_learner_experience.rst b/source/educators/concepts/advanced_features/teams_learner_experience.rst
@@ -113,8 +113,12 @@ For information about course discussions and managing discussions, see
 .. seealso::
  :class: dropdown
 
-  :ref:`Teams Overview <CA_Teams_Overview>` (concept)
-  :ref:`Managing Team Discussions <Teams Discussions>` (concept)
-  :ref:`Enable and Configure Teams` (how-to)
-  :ref:`Teams Configuration Options` (reference)
-  :ref:`Managing Teams via CSV Upload` (reference)
+ :ref:`Teams Overview <CA_Teams_Overview>` (concept)
+
+ :ref:`Managing Team Discussions <Teams Discussions>` (concept)
+
+ :ref:`Enable and Configure Teams` (how-to)
+
+ :ref:`Teams Configuration Options` (reference)
+
+ :ref:`Managing Teams via CSV Upload` (reference)
diff --git a/source/educators/concepts/advanced_features/teams_overview.rst b/source/educators/concepts/advanced_features/teams_overview.rst
@@ -41,8 +41,12 @@ For more information about using discussions, see :ref:`Running_discussions`.
 .. seealso::
  :class: dropdown
 
-  :ref:`Managing Team Discussions <Teams Discussions>` (concept)
-  :ref:`Enable and Configure Teams` (how-to)
-  :ref:`Teams Configuration Options` (reference)
-  :ref:`The Learner's Experience of Teams <CA Learner Experience of Teams>` (concept)
-  :ref:`Managing Teams via CSV Upload` (reference)
+ :ref:`Managing Team Discussions <Teams Discussions>` (concept)
+
+ :ref:`Enable and Configure Teams` (how-to)
+
+ :ref:`Teams Configuration Options` (reference)
+
+ :ref:`The Learner's Experience of Teams <CA Learner Experience of Teams>` (concept)
+
+ :ref:`Managing Teams via CSV Upload` (reference)
diff --git a/source/educators/concepts/advanced_features/timed_exams.rst b/source/educators/concepts/advanced_features/timed_exams.rst
@@ -45,4 +45,3 @@ To better understand the learner's experience of timed exams, see
   Timed exams are different from :ref:`proctored exams<CA_ProctoredExams>`.
   While both types of exams have a time limit, learners are monitored only
   during proctored exams.
-
diff --git a/source/educators/concepts/advanced_features/using_openedx_as_LTI_provider.rst b/source/educators/concepts/advanced_features/using_openedx_as_LTI_provider.rst
@@ -56,8 +56,12 @@ For more information about constructing an LTI URL for a course component, see
 .. seealso::
  :class: dropdown
 
-  :ref:`Create a Duplicate Course for LTI use` (how-to)
-  :ref:`Determine Content Addresses when using Open edX as an LTI Provider<Determine Content Addresses>` (how-to)
-  :ref:`Planning for Content Reuse (LTI)<Planning for Content Reuse>` (reference)
-  :ref:`Example: edX as an LTI Provider to Canvas<edX as an LTI Provider to Canvas>` (reference)
-  :ref:`Example: edX as an LTI Provider to Blackboard<edX as an LTI Provider to Blackboard>` (reference)
+ :ref:`Create a Duplicate Course for LTI use` (how-to)
+
+ :ref:`Determine Content Addresses when using Open edX as an LTI Provider<Determine Content Addresses>` (how-to)
+
+ :ref:`Planning for Content Reuse (LTI)<Planning for Content Reuse>` (reference)
+
+ :ref:`Example: edX as an LTI Provider to Canvas<edX as an LTI Provider to Canvas>` (reference)
+
+ :ref:`Example: edX as an LTI Provider to Blackboard<edX as an LTI Provider to Blackboard>` (reference)
diff --git a/source/educators/concepts/communication/about_divided_discussions.rst b/source/educators/concepts/communication/about_divided_discussions.rst
@@ -65,5 +65,6 @@ Discussion Topics` and :ref:`Running_discussions`.
 .. seealso::
  :class: dropdown
 
-  :ref:`Setting Up Divided Discussions` (how-to)
+ :ref:`Setting Up Divided Discussions` (how-to)
+
 
diff --git a/source/educators/concepts/communication/course_discussions.rst b/source/educators/concepts/communication/course_discussions.rst
@@ -104,4 +104,4 @@ topics, see :ref:`Visibility of Discussion Topics`.
 .. seealso::
  :class: dropdown
 
-  :ref:`Configuring Edx Discussions` (how-to)
+ :ref:`Configuring Edx Discussions` (how-to)
diff --git a/source/educators/concepts/communication/discussion_guidance_moderators.rst b/source/educators/concepts/communication/discussion_guidance_moderators.rst
@@ -176,6 +176,8 @@ Feature Requests
 .. seealso::
  :class: dropdown
 
-  :ref:`Guidance for Discussion Moderators` (concept)
-  :ref:`Assigning_discussion_roles` (how-to)
-  :ref:`Administer Discussions` (how-to)
+ :ref:`Guidance for Discussion Moderators` (concept)
+
+ :ref:`Assigning_discussion_roles` (how-to)
+
+ :ref:`Administer Discussions` (how-to)
diff --git a/source/educators/concepts/communication/index.rst b/source/educators/concepts/communication/index.rst
diff --git a/source/educators/concepts/communication/manage_divided_discussions.rst b/source/educators/concepts/communication/manage_divided_discussions.rst
@@ -228,4 +228,4 @@ you filter the list by a specific group, you see the same, complete set of
 posts that the members of that group see.
 
 For other options that you can use to view posts, see
-:ref:`Moderating_discussions`.
+:ref:`Moderating_discussions`.
diff --git a/source/educators/concepts/communication/moderating_discussions.rst b/source/educators/concepts/communication/moderating_discussions.rst
@@ -206,6 +206,8 @@ all** drop-down menu.
 .. seealso::
  :class: dropdown
 
-  :ref:`Guidance for Discussion Moderators` (concept)
-  :ref:`Assigning_discussion_roles` (how-to)
-  :ref:`Administer Discussions` (how-to)
+ :ref:`Guidance for Discussion Moderators` (concept)
+
+ :ref:`Assigning_discussion_roles` (how-to)
+
+ :ref:`Administer Discussions` (how-to)
diff --git a/source/educators/concepts/communication/running_discussions.rst b/source/educators/concepts/communication/running_discussions.rst
@@ -197,6 +197,8 @@ units and all course-wide topics are affected.
 .. seealso::
  :class: dropdown
 
-  :ref:`Discussions` (concept)
-  :ref:`Configuring Edx Discussions` (how-to)
-  :ref:`Closing Discussions` (how-to)
+ :ref:`Discussions` (concept)
+
+ :ref:`Configuring Edx Discussions` (how-to)
+
+ :ref:`Closing Discussions` (how-to)
diff --git a/source/educators/concepts/data/index.rst b/source/educators/concepts/data/index.rst
diff --git a/source/educators/concepts/data/learner_data.rst b/source/educators/concepts/data/learner_data.rst
@@ -72,5 +72,7 @@ understanding of how the learner population changes over time.
  :class: dropdown
 
  :ref:`Columns in the Student Profile Report` (reference)
+
  :ref:`View and download student data` (how-to)
+
  :ref:`Access Anonymized Learner IDs <Access_anonymized>` (how-to)
diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst
@@ -730,7 +730,10 @@ information, see
 .. seealso::
  :class: dropdown
 
-  :ref:`PA Create an ORA Assignment` (how to)
-  :ref:`Managing ORA Assignments` (how to)
-  :ref:`ORA Staff Grading` (reference)
-  :ref:`Accessing ORA Assignment Information` (reference)
+ :ref:`PA Create an ORA Assignment` (how to)
+
+ :ref:`Managing ORA Assignments` (how to)
+
+ :ref:`ORA Staff Grading` (reference)
+
+ :ref:`Accessing ORA Assignment Information` (reference)
diff --git a/source/educators/concepts/exercise_tools/create_exercises.rst b/source/educators/concepts/exercise_tools/create_exercises.rst
@@ -41,6 +41,6 @@ selection of other exercises and tools that you can add to your course.
 .. seealso::
  :class: dropdown
 
-  :ref:`Core Problem Types` (reference)
-  :ref:'Enable Additional Exercises and Tools' (how to)
+ :ref:`Core Problem Types` (reference)
 
+ :ref:'Enable Additional Exercises and Tools' (how to)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -45,4 +45,3 @@ To better understand the learner's experience of timed exams, see
		Timed exams are different from :ref:`proctored exams<CA_ProctoredExams>`.
		While both types of exams have a time limit, learners are monitored only
		during proctored exams.