diff --git a/source/_images/site_ops_how_tos/course_enable_anonymous_courseware_access.png b/source/_images/site_ops_how_tos/course_enable_anonymous_courseware_access.png new file mode 100644 index 000000000..051b087af Binary files /dev/null and b/source/_images/site_ops_how_tos/course_enable_anonymous_courseware_access.png differ diff --git a/source/_images/site_ops_how_tos/enable_anonymous_courseware_access.png b/source/_images/site_ops_how_tos/enable_anonymous_courseware_access.png new file mode 100644 index 000000000..95d633b5a Binary files /dev/null and b/source/_images/site_ops_how_tos/enable_anonymous_courseware_access.png differ diff --git a/source/conf.py b/source/conf.py index 093defc60..1d53051e3 100644 --- a/source/conf.py +++ b/source/conf.py @@ -104,14 +104,6 @@ "event-routing-backends": ( f"https://event-routing-backends.readthedocs.io/{rtd_language}/{rtd_version}", None ), - "edx-installing-configuring-and-running": ( - f"https://edx.readthedocs.io/projects/edx-installing-configuring-and-running/{rtd_language}/{rtd_version}", - None, - ), - "openedx-building-and-running-a-course": ( - f"https://edx.readthedocs.io/projects/open-edx-building-and-running-a-course/{rtd_language}/{rtd_version}", - None, - ), "edx-platform": ( f"https://docs.openedx.org/projects/edx-platform/{rtd_language}/{rtd_version}", None, diff --git a/source/developers/references/developer_guide/extending_platform/extending.rst b/source/developers/references/developer_guide/extending_platform/extending.rst index 9d3b981e6..2396f099c 100644 --- a/source/developers/references/developer_guide/extending_platform/extending.rst +++ b/source/developers/references/developer_guide/extending_platform/extending.rst @@ -61,7 +61,7 @@ ways to extend the platform, starting with the following table. - Yes * - Clean UI Integration - Yes - - No (see :doc:`openedx-building-and-running-a-course:exercises_tools/lti_component`) + - No (see :ref:`LTI Component`) - Yes - Yes - Yes @@ -72,13 +72,13 @@ ways to extend the platform, starting with the following table. - Yes - Yes * - Server Side Grading - - Possibly (See :doc:`openedx-building-and-running-a-course:exercises_tools/custom_javascript`) + - Possibly (See :ref:`Custom JavaScript`) - Yes - Yes - Yes - Yes * - Usage Data - - No (See :doc:`openedx-building-and-running-a-course:exercises_tools/custom_javascript`) + - No (See :ref:`Custom JavaScript`) - No - Limited - Yes diff --git a/source/developers/references/developer_guide/extending_platform/xblocks.rst b/source/developers/references/developer_guide/extending_platform/xblocks.rst index 7e5c06fd6..3901aa561 100644 --- a/source/developers/references/developer_guide/extending_platform/xblocks.rst +++ b/source/developers/references/developer_guide/extending_platform/xblocks.rst @@ -166,7 +166,7 @@ other course content component, or for sequential or vertical course container component. There are several ways to find the ``usage_id`` for an XBlock in the LMS, including viewing either the staff debug info or the page source. For more information, see -:doc:`openedx-building-and-running-a-course:course_features/lti/lti_address_content`. +:ref:`Determine Content Addresses`. Example XBlock URLs diff --git a/source/educators/concepts/accessibility/design_for_mobile.rst b/source/educators/concepts/accessibility/design_for_mobile.rst index 6c8c18b9f..49fe79fff 100644 --- a/source/educators/concepts/accessibility/design_for_mobile.rst +++ b/source/educators/concepts/accessibility/design_for_mobile.rst @@ -12,8 +12,7 @@ to everyone, regardless of any physical limitation that they might have, and regardless whether they are accessing your course using a Web browser or using mobile apps. -For information about accessibility best practices, see :ref:`Accessibility -Index `. +For information about accessibility best practices, see :ref:`Accessibility Best Practices for Course Content Development`. The percentage of learners who access MOOCs using smartphones is increasing every day. Courses on your instance may be viewed on smartphones using the diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst index 7ad3d0ab7..b44dc982b 100644 --- a/source/educators/concepts/advanced_features/lti_reuse_content.rst +++ b/source/educators/concepts/advanced_features/lti_reuse_content.rst @@ -35,7 +35,7 @@ content in the context of an external LMS. :depth: 1 For information about the content that you can include in an external LMS, see -:ref:`Preparing Content`. +:ref:`Planning for Content Reuse`. ********************************** Course Roster Management @@ -74,7 +74,7 @@ example, edX course discussions can identify participants by their edX IDs instead of the usernames they would normally see in the external LMS. As a result, some edX content is not currently suitable for use in an external LMS. -For more information, see :ref:`Preparing Content`. +For more information, see :ref:`Planning for Content Reuse`. ****************************** Learner Progress and Grades diff --git a/source/educators/concepts/advanced_features/offering_differentiated_content.rst b/source/educators/concepts/advanced_features/offering_differentiated_content.rst index 0b8bb26ae..888edb2d9 100644 --- a/source/educators/concepts/advanced_features/offering_differentiated_content.rst +++ b/source/educators/concepts/advanced_features/offering_differentiated_content.rst @@ -41,7 +41,7 @@ If you have enabled cohorts in your course, you can associate one or more cohort For example, you might intend all learners in your course to have substantially the same course experience, except that you want to show learners who are either current students or alumni of your institution a special video in several sections. You already have your institution's current students in one cohort and alumni in another cohort. By associating both of these cohorts with the same content group, and restricting access to the special institutional-related video to only this content group, you can provide a customized course experience. -For information about creating differentiated content using cohorts, see :ref:`Cohorts Overview` and :ref:`Cohorted Courseware Overview`. +For information about creating differentiated content using cohorts, see :ref:`Cohorts Overview`. .. seealso:: @@ -49,8 +49,6 @@ For information about creating differentiated content using cohorts, see :ref:`C :ref:`Cohorts Overview` (concept) - :ref:`Cohorted Courseware Overview` (concept) - :ref:`About Content Groups` (concept) :ref:`Overview of Content Experiments` (concept) diff --git a/source/educators/concepts/advanced_features/teams_learner_experience.rst b/source/educators/concepts/advanced_features/teams_learner_experience.rst index 7c56fa9e0..793524405 100644 --- a/source/educators/concepts/advanced_features/teams_learner_experience.rst +++ b/source/educators/concepts/advanced_features/teams_learner_experience.rst @@ -7,7 +7,7 @@ The Learner's Experience of Teams .. tags:: educator, concept -After you have :ref:`enabled teams ` and created topics in your +After you have :ref:`enabled teams ` and created topics in your course, learners can begin browsing topics and joining teams. Teams are formed within topics. Each learner can belong to only one team. 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 index e67f8660d..62ee3bd3b 100644 --- a/source/educators/concepts/advanced_features/using_openedx_as_LTI_provider.rst +++ b/source/educators/concepts/advanced_features/using_openedx_as_LTI_provider.rst @@ -51,7 +51,7 @@ requirements. a learner and not a TA or course designer. For more information about constructing an LTI URL for a course component, see -:ref:`Determining Content Addresses`. +:ref:`Determine Content Addresses`. .. seealso:: :class: dropdown @@ -62,6 +62,6 @@ For more information about constructing an LTI URL for a course component, see :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Canvas` (reference) + :ref:`Example: Open edX as an LTI Provider to Canvas` (reference) - :ref:`Example: edX as an LTI Provider to Blackboard` (reference) \ No newline at end of file + :ref:`Example: edX as an LTI Provider to Blackboard` (reference) \ No newline at end of file diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index 19344a34c..7771a09cd 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -18,7 +18,7 @@ assessment) to complete the assignment. an open response assessment divided by cohort, you must create that assessment in a course component that is defined as cohort-specific. For more information about cohorts and creating cohort-specific course content, see - :ref:`Cohorts Overview ` and :ref:`Cohorted Courseware Overview `. + :ref:`Cohorts Overview ` and :ref:`Offering Differentiated Content to Different Learner Groups `. The following topics provide conceptual information about open response assessments. @@ -374,7 +374,7 @@ steps, and make it available only to the members of one or more specific cohorts. For the members of the remaining cohorts, you create an ORA assignment that has only the peer assessment step. For details about creating different course experiences for learners in different cohorts, see -:ref:`Cohorted Courseware Overview `. +:ref:`Create Cohort Specific Course Content `. For details about performing grading in staff assessment steps, see :ref:`Perform a Staff Assessment`. @@ -710,8 +710,7 @@ change. This set of file name extensions is provided as the default for Open edX installations. Open edX system administrators can update this list. For more -information, see -:ref:`Configuring ORA2 to Prohibit Submission of File Types `. +information, see `Configuring ora2 to prohibit submission of file types`_. .. list-table:: :widths: 15 75 diff --git a/source/educators/concepts/grading/graded_subsections.rst b/source/educators/concepts/grading/graded_subsections.rst index 4b8a2760f..11366635d 100644 --- a/source/educators/concepts/grading/graded_subsections.rst +++ b/source/educators/concepts/grading/graded_subsections.rst @@ -1,3 +1,5 @@ +.. _Graded Subsections: + ################## Graded Subsections ################## diff --git a/source/educators/concepts/open_edx_platform/outline_studio_lms.rst b/source/educators/concepts/open_edx_platform/outline_studio_lms.rst index 6ccda0734..60199eb87 100644 --- a/source/educators/concepts/open_edx_platform/outline_studio_lms.rst +++ b/source/educators/concepts/open_edx_platform/outline_studio_lms.rst @@ -21,8 +21,7 @@ The numbers represent the following levels. #. :ref:`Units` .. note:: - The **Course Outline** page does not show :ref:`components`. You add or access components by selecting the units + The **Course Outline** page does not show :ref:`components`. You add or access components by selecting the units that contain the components. =========================== @@ -42,5 +41,4 @@ If a learner selects the **Resume Course** option, the course opens to the unit that the learner most recently completed. For information about more specific learner data, including the learner's -grades or answers for individual problems, see :ref:`Manage Student Progress -Index`. \ No newline at end of file +grades or answers for individual problems, see :ref:`Learner Data`. diff --git a/source/educators/concepts/planning_course_run_information/set_up_course.rst b/source/educators/concepts/planning_course_run_information/set_up_course.rst index 9d24b7781..c6f058a90 100644 --- a/source/educators/concepts/planning_course_run_information/set_up_course.rst +++ b/source/educators/concepts/planning_course_run_information/set_up_course.rst @@ -31,4 +31,4 @@ outline, see the section on :ref:`Creating a Course in Open edX® ` \ No newline at end of file + :ref:`Creating a New Course ` diff --git a/source/educators/concepts/proctored_exams/preparing_learners_proctored_exams.rst b/source/educators/concepts/proctored_exams/preparing_learners_proctored_exams.rst index 9f4076b96..d9167319f 100644 --- a/source/educators/concepts/proctored_exams/preparing_learners_proctored_exams.rst +++ b/source/educators/concepts/proctored_exams/preparing_learners_proctored_exams.rst @@ -15,8 +15,7 @@ To prepare learners for a proctored exam, follow these guidelines: * Explain what proctored exams are, and provide learners with links to the `OE SFD Proctored Exams`_ topic in the *Open edX Learner’s Guide*. -* Communicate the rules for proctored exams, including the :ref:`online - proctoring rules` in the *Open edX Learner’s +* Communicate the rules for proctored exams, including the :ref:`Online Proctoring Rules` in the *Open edX Learner’s Guide* as well as any specific rules for a particular exam. For information about creating specific rules, see :ref:`specifying_exam_rules_and_exceptions`. diff --git a/source/educators/concepts/proctored_exams/proctored_exams_overview.rst b/source/educators/concepts/proctored_exams/proctored_exams_overview.rst index c096ac032..316ac2f7c 100644 --- a/source/educators/concepts/proctored_exams/proctored_exams_overview.rst +++ b/source/educators/concepts/proctored_exams/proctored_exams_overview.rst @@ -10,7 +10,7 @@ Proctored exams are timed exams that learners take while online proctoring software monitors their computer, environment, and behavior. When learners complete a proctored exam, the recording of the exam is examined to determine whether the learner complied with the :ref:`online proctoring rules -`. +`. Learners must be in the verified enrollment track to take a proctored exam. diff --git a/source/educators/how-tos/add_course_creators.rst b/source/educators/how-tos/add_course_creators.rst index 63518d7be..004624d39 100644 --- a/source/educators/how-tos/add_course_creators.rst +++ b/source/educators/how-tos/add_course_creators.rst @@ -40,7 +40,7 @@ For a step-by-step to grant staff permissions to courses, check out this video: :ref: `Add Beta Testers to a CourseAdd Beta Testers to a CourseAdd Beta Testers to a Course` (how-to) - :ref: `Add Course Team Members` (how-to) + :ref: `Add Course Staff` (how-to) :ref: `Planning Course Staff` (reference) diff --git a/source/educators/how-tos/add_video_quiz.rst b/source/educators/how-tos/add_video_quiz.rst index 43a2a4b24..562da6805 100644 --- a/source/educators/how-tos/add_video_quiz.rst +++ b/source/educators/how-tos/add_video_quiz.rst @@ -21,6 +21,8 @@ It's possible to add quizzes directly to a video! Watch this for a how-to: :ref:`Troubleshoot Videos` (reference) + :ref:`Video Guidelines` (reference) + :ref:`Create a Video` (how-to) :ref:`Specifying Additional Video Options ` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/advanced_features/add_cohorts.rst b/source/educators/how-tos/advanced_features/add_cohorts.rst index eefe58669..48d695b56 100644 --- a/source/educators/how-tos/advanced_features/add_cohorts.rst +++ b/source/educators/how-tos/advanced_features/add_cohorts.rst @@ -26,7 +26,7 @@ add a cohort to your course, follow these steps. #. Optionally, select **Select a Content Group** to associate the cohort with a :ref:`content group`. For information about creating cohort-specific course content by associating cohorts with content groups, - see :ref:`Cohorted Courseware Overview`. + see :ref:`Cohorts Overview` and :ref:`Offering Differentiated Content`. #. Select **Save**. diff --git a/source/educators/how-tos/advanced_features/cohorted_courseware.rst b/source/educators/how-tos/advanced_features/cohorted_courseware.rst index 132ac8ac4..bbf04d5b1 100644 --- a/source/educators/how-tos/advanced_features/cohorted_courseware.rst +++ b/source/educators/how-tos/advanced_features/cohorted_courseware.rst @@ -17,7 +17,7 @@ cohorts. Overview ********* -If you have :ref:`Enable Cohorts` in your +If you have :ref:`enabled cohorts` in your course, you can create different course experiences for learners in different cohorts. @@ -36,7 +36,7 @@ Complete these steps to create cohort-specific content in your course. In Studio -#. :ref:`Enable cohorts in your course`. +#. :ref:`Enable cohorts in your course`. #. :ref:`Create content groups`. #. :ref:`Specify components or units as available only to particular content groups`. @@ -61,7 +61,7 @@ University Alumni and Current University Students. Learners who are not in either of these cohorts are automatically placed into a third cohort, the default cohort, when they access the **Course** or **Discussion** tabs in the course. For more information about enabling cohorts in your course and -assigning students to cohorts, see :ref:`Enabling and Configuring Cohorts`. +assigning students to cohorts, see :ref:`Manage Course Cohorts`. You intend all learners to have substantially the same course experience, with the exception that only learners in the two university-related cohorts will diff --git a/source/educators/how-tos/advanced_features/configure_content_experiments.rst b/source/educators/how-tos/advanced_features/configure_content_experiments.rst index a98eb71d7..b8d2d6ed4 100644 --- a/source/educators/how-tos/advanced_features/configure_content_experiments.rst +++ b/source/educators/how-tos/advanced_features/configure_content_experiments.rst @@ -15,6 +15,10 @@ To enable content experiments in your course, you must add ``split_test`` to the .. _Enable Content Experiments: +********************************* +Enable Content Experiments +********************************* + #. From the **Settings** menu, select **Advanced Settings**. #. On the **Advanced Settings** page, locate **Advanced Module List**. diff --git a/source/educators/how-tos/advanced_features/create_content_experiment.rst b/source/educators/how-tos/advanced_features/create_content_experiment.rst index d2f9e612a..60e6ba5a0 100644 --- a/source/educators/how-tos/advanced_features/create_content_experiment.rst +++ b/source/educators/how-tos/advanced_features/create_content_experiment.rst @@ -24,7 +24,7 @@ completed the following tasks. The content experiment includes a container for each group that is defined in the group configuration you selected. You create content for each experiment group as you do any other component. For more information, see - :ref:`Developing Course Components`. + :ref:`Add a Component`. #. Select either **Select a Group Configuration** or **Edit** to open the content experiment component. diff --git a/source/educators/how-tos/advanced_features/lti_blackboard_example.rst b/source/educators/how-tos/advanced_features/lti_blackboard_example.rst index c666ab207..3e64fbadd 100644 --- a/source/educators/how-tos/advanced_features/lti_blackboard_example.rst +++ b/source/educators/how-tos/advanced_features/lti_blackboard_example.rst @@ -35,7 +35,7 @@ To use Open edX course content in the Blackboard LMS, you add a new app to the c :alt: The Blackboard Create Web Link page with example name and URL values. - For more information, see :ref:`Determining Content Addresses`. + For more information, see :ref:`Determine Content Addresses`. #. Review the content to verify that it appears as you expect. @@ -54,4 +54,4 @@ To use Open edX course content in the Blackboard LMS, you add a new app to the c :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Canvas` (reference) + :ref:`Example: Open edX as an LTI Provider to Canvas` (reference) diff --git a/source/educators/how-tos/advanced_features/lti_canvas_example.rst b/source/educators/how-tos/advanced_features/lti_canvas_example.rst index e32d50a29..58299234d 100644 --- a/source/educators/how-tos/advanced_features/lti_canvas_example.rst +++ b/source/educators/how-tos/advanced_features/lti_canvas_example.rst @@ -26,7 +26,7 @@ To use Open edX course content in the Canvas LMS, you add a new app to the cours :alt: The Canvas page where you add an external tool and supply the LTI URL. - For more information, see :ref:`Determining Content Addresses`. + For more information, see :ref:`Determine Content Addresses`. #. Review the content to verify that it appears as you expect. @@ -45,4 +45,4 @@ To use Open edX course content in the Canvas LMS, you add a new app to the cours :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Blackboard` (how-to) \ No newline at end of file + :ref:`Example: edX as an LTI Provider to Blackboard` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/advanced_features/lti_determine_content_address.rst b/source/educators/how-tos/advanced_features/lti_determine_content_address.rst index 68b67c696..3c0189209 100644 --- a/source/educators/how-tos/advanced_features/lti_determine_content_address.rst +++ b/source/educators/how-tos/advanced_features/lti_determine_content_address.rst @@ -216,8 +216,8 @@ LTI URLs for Text components include "html+block" or "html", as follows. :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Canvas` (reference) + :ref:`Example: Open edX as an LTI Provider to Canvas` (reference) - :ref:`Example: edX as an LTI Provider to Blackboard` (reference) + :ref:`Example: edX as an LTI Provider to Blackboard Provider ` (reference) diff --git a/source/educators/how-tos/advanced_features/lti_prepare_content.rst b/source/educators/how-tos/advanced_features/lti_prepare_content.rst index 338a63617..52f7e1b63 100644 --- a/source/educators/how-tos/advanced_features/lti_prepare_content.rst +++ b/source/educators/how-tos/advanced_features/lti_prepare_content.rst @@ -64,6 +64,6 @@ steps. :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Canvas` (reference) + :ref:`Example: Open edX as an LTI Provider to Canvas` (reference) - :ref:`Example: edX as an LTI Provider to Blackboard` (reference) + :ref:`Example: edX as an LTI Provider to Blackboard` (reference) diff --git a/source/educators/how-tos/advanced_features/timed_exams.rst b/source/educators/how-tos/advanced_features/timed_exams.rst index c557b2085..7eb855bc2 100644 --- a/source/educators/how-tos/advanced_features/timed_exams.rst +++ b/source/educators/how-tos/advanced_features/timed_exams.rst @@ -6,6 +6,8 @@ Configure Timed Exams .. tags:: educator, how-to +.. _Enable Timed Exams: + ******************* Enable Timed Exams ******************* @@ -59,7 +61,7 @@ steps. If your course has the proctored exam feature enabled, the **Advanced** tab also shows options for :ref:`proctored and practice - proctored exams`. + proctored exams`. #. In the **Time Allotted** field, enter the length of time that you want learners to have to complete the problems in the subsection. Enter the time diff --git a/source/educators/how-tos/communication/configure-discussions.rst b/source/educators/how-tos/communication/configure-discussions.rst index f13a0339d..26e9d5244 100644 --- a/source/educators/how-tos/communication/configure-discussions.rst +++ b/source/educators/how-tos/communication/configure-discussions.rst @@ -88,9 +88,11 @@ Discussion list now includes the topic you added. configure these topics to be divided by cohort. For more information, see :ref:`Divide Course Wide Discussion Topics`. +.. _Enable Discussion on a Course Unit: -Upgraded Open edX Forum -======================= +********************************** +Enable Discussion on a Course Unit +********************************** Discussion can be enabled for a course unit, which is equivalent to adding a content-specific discussion topic in that unit in the :ref:`legacy version of diff --git a/source/educators/how-tos/communication/setting_up_divided_discussions.rst b/source/educators/how-tos/communication/setting_up_divided_discussions.rst index 4d5b1fb3b..c496718f6 100644 --- a/source/educators/how-tos/communication/setting_up_divided_discussions.rst +++ b/source/educators/how-tos/communication/setting_up_divided_discussions.rst @@ -12,8 +12,7 @@ Setting Up Divided Discussions By default, all :ref:`course-wide discussion topics` and :ref:`content-specific discussion topics` are unified: all learners can interact +Discussion Topics>` and :ref:`content-specific discussion topics` are unified: all learners can interact with all posts, responses, and comments. You can change discussion topics of either type to be divided or unified on the discussions configuration page (see :ref:`Create CourseWide Discussion Topics`). @@ -39,8 +38,7 @@ topics. Divide All Content-Specific Discussion Topics ********************************************* -When you :ref:`create content-specific discussion topics` by adding discussion components to units +When you :ref:`create content-specific discussion topics` by adding discussion components to units in Studio, these discussion topics are by default unified. All learners in the course can see and respond to posts from all other learners. You can change content-specific discussion topics to be divided, so that only members of the diff --git a/source/educators/how-tos/configure_prerequisite_content.rst b/source/educators/how-tos/configure_prerequisite_content.rst index 71dfec1ff..15c2808c6 100644 --- a/source/educators/how-tos/configure_prerequisite_content.rst +++ b/source/educators/how-tos/configure_prerequisite_content.rst @@ -12,7 +12,7 @@ in the course outline with a lock icon, and learners cannot view the subsection content until they have earned a minimum score in the prerequisite subsection. .. note:: - You must first :ref:`Enable Course Prerequisites` before + You must first :ref:`Set up Course Prerequisites` before prerequisite course subsections can be used. .. _enabling_subsection_gating: @@ -47,8 +47,7 @@ subsection, follow these steps. learners. .. note:: - You cannot use :ref:`open response assessments` that have a point value of 0 as the prerequisite for other course + You cannot use :ref:`Open Response Assessments` that have a point value of 0 as the prerequisite for other course subsections. #. Enable subsection prerequisites for your course. For more information, see @@ -114,7 +113,7 @@ subsection, follow these steps. :width: 600 .. note:: Prerequisite course subsection settings are not retained when - you :ref:`export or import a course`, or + you :ref:`Export a Course` and :ref:`Import a Course`, or when you :ref:`re-run a course`. .. seealso:: diff --git a/source/educators/how-tos/course_development/add_video_to_course.rst b/source/educators/how-tos/course_development/add_video_to_course.rst index 5a2d1aebe..58155eb63 100644 --- a/source/educators/how-tos/course_development/add_video_to_course.rst +++ b/source/educators/how-tos/course_development/add_video_to_course.rst @@ -43,6 +43,8 @@ To add a video, follow these steps. :ref:`Troubleshoot Videos` (reference) + :ref:`Video Guidelines` (reference) + :ref:`Create a Video` (how-to) :ref:`Specifying Additional Video Options ` (how-to) diff --git a/source/educators/how-tos/course_development/additional_video_options.rst b/source/educators/how-tos/course_development/additional_video_options.rst index 09fa4d7a2..0a9f8d032 100644 --- a/source/educators/how-tos/course_development/additional_video_options.rst +++ b/source/educators/how-tos/course_development/additional_video_options.rst @@ -132,7 +132,7 @@ Transcript * - **Transcript Languages** - The transcript files for any additional languages. For more - information, see :ref:`Transcripts in Additional Languages`. + information, see :ref:`Transcripts in Additional Languages`. * - **Download Transcript Allowed** - Specifies whether you want to allow learners to download the .srt or @@ -241,6 +241,8 @@ License :ref:`Troubleshoot Videos` (reference) + :ref:`Video Guidelines` (reference) + :ref:`Create a Video` (how-to) :ref:`Add an In Video Quiz` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/configure_resources.rst b/source/educators/how-tos/course_development/configure_resources.rst index d9aea5720..7a6950624 100644 --- a/source/educators/how-tos/course_development/configure_resources.rst +++ b/source/educators/how-tos/course_development/configure_resources.rst @@ -91,7 +91,7 @@ Configuring the Teams application ********************************** Additional management and configuration of the teams application can be done through the main Team application tab -in the learner experience, and is detailed in :ref:`12.4.1 Using the Teams application`. +in the learner experience, and is detailed in :ref:`Using the Teams application`. .. _ORA Coursewide Settings: diff --git a/source/educators/how-tos/course_development/create_edit_publish_subsections.rst b/source/educators/how-tos/course_development/create_edit_publish_subsections.rst index 25b0a4d03..c7f325619 100644 --- a/source/educators/how-tos/course_development/create_edit_publish_subsections.rst +++ b/source/educators/how-tos/course_development/create_edit_publish_subsections.rst @@ -145,6 +145,6 @@ To delete a subsection, follow these steps. :ref:`Use a Section from a Course independently of the Course Outline` (how-to) - :ref:`Resources for Course Teams ` (reference) + :ref:`Resources for Open edX Course Teams ` (reference) :ref:`Resources for Open edX` (reference) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/exercise_tools/Manage_ORA_Assignment.rst b/source/educators/how-tos/course_development/exercise_tools/Manage_ORA_Assignment.rst index 5c5a782cf..32942b5e6 100644 --- a/source/educators/how-tos/course_development/exercise_tools/Manage_ORA_Assignment.rst +++ b/source/educators/how-tos/course_development/exercise_tools/Manage_ORA_Assignment.rst @@ -19,7 +19,7 @@ assessments. * :ref:`Best practices for ORA assignments` -* :ref:`Components of an ORA assignment` +* :ref:`Components of an ORA assignment` * :ref:`Instructions for creating an ORA assignment` diff --git a/source/educators/how-tos/course_development/exercise_tools/adding_multi_select.rst b/source/educators/how-tos/course_development/exercise_tools/adding_multi_select.rst index 5edc503ea..a547d8068 100644 --- a/source/educators/how-tos/course_development/exercise_tools/adding_multi_select.rst +++ b/source/educators/how-tos/course_development/exercise_tools/adding_multi_select.rst @@ -137,7 +137,7 @@ advanced editor. In the setting panels on the right of the editor, click **Switch to advanced editor**. You can use the advanced editor to identify the elements of a multi-select problem -with OLX. For more information, see :ref:`Multi-select Problem XML`. To format equations, +with OLX. For more information, see :ref:`Multi select Problem XML`. To format equations, you can use MathJax. For more information, see :ref:`MathJax in Studio`. You can see the OLX for the example problem from the Overview section below. diff --git a/source/educators/how-tos/course_development/exercise_tools/creating_a_drag_and_drop_problem.rst b/source/educators/how-tos/course_development/exercise_tools/creating_a_drag_and_drop_problem.rst index c9224f1d9..24a75ea30 100644 --- a/source/educators/how-tos/course_development/exercise_tools/creating_a_drag_and_drop_problem.rst +++ b/source/educators/how-tos/course_development/exercise_tools/creating_a_drag_and_drop_problem.rst @@ -58,7 +58,7 @@ To create a drag and drop problem, follow these steps. dialog box. -.. _changing_visual_style_of_drag_and_drop_problem: +.. _Styling Drag and Drop Problems: Changing the Visual Style of a Drag and Drop Problem **************************************************** @@ -72,7 +72,8 @@ edit a drag and drop problem. You can develop a Python programming language module and include a custom Cascading Style Sheet (CSS) file for drag and drop problems in your Open edX -site. For more information, see :ref:`styling_drag_and_drop_problems`. +site. For more information, see :ref:`Styling Drag and Drop Problems`. + .. seealso:: :class: dropdown diff --git a/source/educators/how-tos/course_development/exercise_tools/edit_numerical_input_advanced.rst b/source/educators/how-tos/course_development/exercise_tools/edit_numerical_input_advanced.rst index 20ec5bc76..0e479fc92 100644 --- a/source/educators/how-tos/course_development/exercise_tools/edit_numerical_input_advanced.rst +++ b/source/educators/how-tos/course_development/exercise_tools/edit_numerical_input_advanced.rst @@ -37,6 +37,8 @@ You can see the OLX for the example problem from the Overview section below. changes you make in the advanced editor, you may not be able to cannot switch back to the simple editor. +.. _Use Feedback in a Numerical Input Problems: + =================== Adding Feedback =================== diff --git a/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst b/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst index 7ca703657..0c86ca3db 100644 --- a/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst +++ b/source/educators/how-tos/course_development/exercise_tools/use_randomized_content_blocks.rst @@ -15,7 +15,7 @@ team who have **Admin** access to that library can grant you access. The libraries that you create or have access to are listed on the **Libraries** tab on the Studio Home page. For details about content libraries, see -:ref:`Content Libraries`. +:ref:`Content Libraries Overview`. Using components from content libraries in your course involves two steps. diff --git a/source/educators/how-tos/course_development/library_access.rst b/source/educators/how-tos/course_development/library_access.rst index 35e83067e..6ec39d803 100644 --- a/source/educators/how-tos/course_development/library_access.rst +++ b/source/educators/how-tos/course_development/library_access.rst @@ -117,8 +117,9 @@ steps. addition, their listing now includes a button to remove their current level of access and move them back to their previous level of access. For details about reducing a user's level of access to a library, see :ref:`Remove Staff - or Admin Access`. + or Admin Access`. +.. _Remove Staff or Admin Access: **************************** Remove Staff or Admin Access 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 index 52c8d72af..c26c170e0 100644 --- a/source/educators/how-tos/course_development/set_subsection_problem_date.rst +++ b/source/educators/how-tos/course_development/set_subsection_problem_date.rst @@ -47,8 +47,6 @@ To set the assignment type and due date for a subsection, follow these steps. #. Select **Save**. -For more information, see :ref:`Grading Index`. - .. _Problem Results Visibility: ********************************* @@ -72,7 +70,7 @@ The **Assessment Results Visibility** setting can be used with the following common problem types. * :ref:`Dropdown` -* :ref:`Multi-select` +* :ref:`Multi select` * :ref:`Numerical Input` * :ref:`Single Select` * :ref:`Text Input` diff --git a/source/educators/how-tos/course_development/video_process_overview.rst b/source/educators/how-tos/course_development/video_process_overview.rst index 96b2ce7bc..bfff9924d 100644 --- a/source/educators/how-tos/course_development/video_process_overview.rst +++ b/source/educators/how-tos/course_development/video_process_overview.rst @@ -12,16 +12,13 @@ The following diagram outlines the general process for adding videos to a course :alt: The process for adding videos to a course, as outlined in the following numbered steps. -#. The course team :ref:`prepares to add videos to the course `. These steps can happen simultaneously. - * The course team sets up a third party :ref:`hosting service ` to provide a location for course videos. +#. The course team :ref:`prepares to add videos to the course