From 7e46493e0b711a6dd5a58cad05616e8c16e7cc10 Mon Sep 17 00:00:00 2001 From: jswope00 Date: Wed, 8 Jan 2025 14:53:54 -0500 Subject: [PATCH] Adjust RST Formatting and Add See Also links (#701) * Adjust RST Formatting and Add See Also links * tmp delete references that will occur in other PRs --- .../advanced_features/teams_overview.rst | 4 +- .../id_instructional_design_overview.rst | 39 ++++++++-- .../instructional_design/id_templates.rst | 18 ++++- .../additional_course_run_information.rst | 15 +++- .../educators/how-tos/add_course_creators.rst | 3 + source/educators/how-tos/add_image.rst | 16 +++- .../how-tos/add_transcript_other_language.rst | 12 ++- source/educators/how-tos/add_units.rst | 3 + source/educators/how-tos/add_video_quiz.rst | 22 +++++- .../educators/how-tos/add_written_content.rst | 10 ++- ...content_for_specific_enrollment_tracks.rst | 4 +- .../configure_prerequisite_content.rst | 19 +++-- .../how-tos/copy_paste_course_content.rst | 8 +- source/educators/how-tos/copy_paste_units.rst | 11 ++- .../add_video_to_course.rst | 18 ++++- .../additional_transcript_options.rst | 9 ++- .../additional_video_options.rst | 17 ++++- .../configure_resources.rst | 43 ++++++----- .../create_edit_publish_subsections.rst | 43 ++++++++++- .../exercise_tools/create_iframe.rst | 11 ++- .../how-tos/course_development/hide_units.rst | 25 ++++--- .../set_component_restrictions.rst | 11 ++- .../set_restrictions_unit.rst | 9 ++- source/educators/how-tos/course_reruns.rst | 12 ++- source/educators/how-tos/create_course.rst | 8 +- .../how-tos/create_course_about_page.rst | 3 + source/educators/how-tos/create_section.rst | 48 +++++++++++- .../educators/how-tos/create_subsection.rst | 73 +++++++++---------- source/educators/how-tos/create_video.rst | 22 +++++- .../how-tos/grading/set_grace_period.rst | 7 +- .../how-tos/grading/set_grade_range.rst | 8 +- .../how-tos/import_scorm_content.rst | 10 +++ .../educators/how-tos/issue_certificates.rst | 13 +++- .../educators/how-tos/set_up_certificates.rst | 18 ++++- .../set_up_course/add_course_staff.rst | 13 +++- .../how-tos/set_up_course/add_metadata.rst | 45 +++++++++++- .../set_up_course/create_certificates.rst | 12 +++ .../set_up_course/creating_new_course.rst | 18 +++++ .../how-tos/set_up_course/describe_course.rst | 19 ++++- .../set_up_course/edit_certificate.rst | 19 ++++- .../how-tos/set_up_course/enable_badges.rst | 19 ++++- .../set_up_course/set_prerequisites.rst | 7 ++ .../how-tos/set_up_prerequisites.rst | 3 + .../educators/how-tos/update_rerun_course.rst | 4 +- ...ection_independently_of_course_outline.rst | 3 + .../accessibility/accessibility_checker.rst | 5 +- .../controlling_content_visibility.rst | 11 ++- source/educators/references/course_dates.rst | 22 ++++-- .../about_image_guidelines.rst | 21 ++++-- .../add_video_to_course.rst | 14 ++-- .../additional_course_information.rst | 16 +++- .../course_development/course_about_page.rst | 14 +++- .../course_development/course_staff.rst | 12 ++- .../course_development/course_subsections.rst | 41 +++++++++++ .../course_title_guidelines.rst | 16 ++-- .../develop_course_sections.rst | 45 +++++++++++- .../modify_outline_settings.rst | 41 ++++++++++- .../publish_from_outline.rst | 44 ++++++++++- .../course_development/rerunning_course.rst | 10 ++- .../course_development/troubleshoot_video.rst | 13 ++-- .../understanding_course_outline.rst | 46 +++++++++++- .../unit_workflow_and_status.rst | 23 +++++- .../what_is_a_component.rst | 13 +++- source/educators/references/course_pacing.rst | 2 + .../references/data/answer_report_faq.rst | 6 +- .../data/certificate_report_columns.rst | 7 +- .../interpreting_problem_grade_report.rst | 8 +- .../references/resources_for_course_teams.rst | 6 +- .../references/resources_for_open_edx.rst | 2 + 69 files changed, 979 insertions(+), 213 deletions(-) diff --git a/source/educators/concepts/advanced_features/teams_overview.rst b/source/educators/concepts/advanced_features/teams_overview.rst index 2e53a5c8a..ea251c25f 100644 --- a/source/educators/concepts/advanced_features/teams_overview.rst +++ b/source/educators/concepts/advanced_features/teams_overview.rst @@ -1,8 +1,8 @@ .. _CA_Teams_Overview: -******************************* +*************** Teams Overview -******************************* +*************** .. tags:: educator, concept diff --git a/source/educators/concepts/instructional_design/id_instructional_design_overview.rst b/source/educators/concepts/instructional_design/id_instructional_design_overview.rst index ec9c7437e..1c3895bef 100644 --- a/source/educators/concepts/instructional_design/id_instructional_design_overview.rst +++ b/source/educators/concepts/instructional_design/id_instructional_design_overview.rst @@ -1,3 +1,6 @@ +.. _Instructional Design Overview: + +############################# Instructional Design Overview ############################# @@ -7,16 +10,17 @@ Instructional Design Overview :local: :class: no-bullets - +********************* Instructional Design -******************** +********************* +============================= What is instructional Design? ============================= Instructional design is a combination of educational psychology, communications and user experience design. Instructional design in its most basic term is the creation of materials used to teach. However, instructional design goes beyond just the creation of materials to considering the best approaches and tools for teaching depending on the learner and the educational platform. Today, instructional design has become synonymous with online learning. - +================================== An Introduction to the ADDIE Model ================================== @@ -37,6 +41,7 @@ The approach below is a revision of the ADDIE model that will be discussed in mo .. image:: /_images/instructional_design/addie_model.png :alt: An ADDIE Model Diagram +===================================== The Role of an Instructional Designer ===================================== @@ -57,12 +62,14 @@ A subject matter expert (SME): - Grades submitted assignments (if applicable) - Provides ongoing academic support/communication during delivery +***************************** Alignment & Backwards Design ***************************** .. image:: /_images/instructional_design/backwards_design.png :alt: A Backward Design Diagram - Identify Result, Determine Evidence, Plan Teaching and Learning +================ Backwards Design ================ @@ -79,6 +86,7 @@ Designing a course requires an SME and ID to work backwards. .. _ConstructiveAlignment: +====================== Constructive Alignment ====================== @@ -96,6 +104,7 @@ One way to double check if your course is aligned is to check your assessment ag - If a learning outcome says a learner should "identify", do you have a checkbox or multiple choice question about that topic? - If a learning outcome says a learner should "discuss", do you have a discussion forum? A peer-graded assessment? +*************************************** Defining Goals, Objectives and Outcomes *************************************** @@ -108,6 +117,7 @@ Learning Goals, Objectives and Outcomes are three course design terms that are o - **Learning Objectives:** are **instructor focused**. Objectives are the things that the instructor wants to teach or accomplish in the course. Objectives are translated into outcomes. - **Learning Outcomes:** are **learner focused**. Learning outcomes are statements that provide clarity about what a learner should know or be able to do at the end of a course. +============== Learning Goals ============== @@ -129,7 +139,7 @@ Examples of learning goals: > An ‘Audience Analysis’ template [[LINK]](/docs/templates/template_audience_analysis) can help you think through who your audience will be and why they might be interested in (motivated or required to) take your course. - +=================== Learning Objectives =================== @@ -152,6 +162,7 @@ Examples of learning objectives: - Present 3 case studies as examples of information manipulation - Explain the four main tactics used in information manipulation campaigns; provide examples. +================= Learning Outcomes ================= @@ -195,6 +206,7 @@ Examples of learning outcomes > [[Link to Outcome & Alignment template]](/docs/templates/template_outcomes) +***************** Learning Theories ***************** @@ -212,6 +224,7 @@ Instructional designers and subject matter experts will use various learning the .. _ActiveLearning: +*************** Active Learning *************** @@ -242,9 +255,11 @@ Below is a list of engagement trigger examples that can be built into your cours - Annotate an image or text. - Use a padlet board for sharing ideas. +*********** Assessments *********** +=========== Why assess? =========== @@ -254,6 +269,7 @@ There are three main reasons why outcomes are assessed: 2. For certification: to provide a grade, rank, certification or degree, to complete training or job performance requirements, and to meet governing body regulations. 3. For quality assurance: to assess the achievement of course/program aims (learning goals), to track learning achievement over time, and to protect the profession and the public. +============== How to Assess? ============== @@ -264,6 +280,7 @@ There are different types of assessment, all of which can be graded or ungraded It is important to provide hints, explanations and feedback for all formative assessments (and it is encouraged for summative assessments). +======================= Examples of assessments ======================= @@ -279,9 +296,11 @@ Examples of assessments .. _MotivationCommunication: +************************** Motivation & Communication ************************** +=================== What is motivation? =================== @@ -292,6 +311,7 @@ Motivation is the force that encourages a learning to persist even when they mee Many learners are primarily motivated (or moved to engage in learning behaviours) by external factors which can include requirements from an employer, the opportunity for payment/advancement in their career, to meet the expectations of others, or by deadlines. Timelines and deadlines are motivators because failing to meet those deadlines can have negative consequences that results in either more effort required (repeating a course or training program) or being unable to progress (get a promotion, be approved to engage in certain tasks, etc.). +======================== ARCS Model of Motivation ======================== @@ -305,6 +325,7 @@ The **ARCS model of motivation** is widely used in eLearning which focuses on cr - **Confidence:** This refers to developing an expectation of success among learners. This is achieved by clear communication of learning outcomes, providing feedback and opportunities for practice and allowing learners to have control of their own learning. - **Satisfaction:** This refers to the direct connection between satisfaction and motivation. Encouraging intrinsic enjoyment of learning, ensuring equal standards across the course, and provide feedback and ‘rewards’ to boost satisfaction. +============================= Additional Motivation Factors ============================= @@ -319,13 +340,19 @@ One really important aspect of motivating learners is providing clear, explicit Providing clear instructions, articulating expectations and providing feedback are ways that an instructional designer can help learners gain motivation. Understanding why something is being taught or assessed can help learners tap into the strategies and skills needed to complete a learning task. Of course, communication is key to ensuring that learners complete tasks on time and to the level of effort that is expected. +****************************** Online Learning Best Practices ****************************** -As you get started building your online course in Open EdX, here are five important principles to keep in mind: +As you get started building your online course on your platform, here are five important principles to keep in mind: 1. Clearly define the learning goals and outcomes. 2. Match your learning outcomes to the content you present and the ways you assess learning. 3. Create opportunities for learners to engage with a) what they’ve learned, b) their peers, c) the course instructor. 4. Think about the needs and motivations of different learners. -5. Create a course outline before you start building. \ No newline at end of file +5. Create a course outline before you start building. + +.. seealso:: + :class: dropdown + + :ref:`Instructional Design Templates` (concept) \ No newline at end of file diff --git a/source/educators/concepts/instructional_design/id_templates.rst b/source/educators/concepts/instructional_design/id_templates.rst index a3fdacde9..ad501296c 100644 --- a/source/educators/concepts/instructional_design/id_templates.rst +++ b/source/educators/concepts/instructional_design/id_templates.rst @@ -1,3 +1,6 @@ +.. _Instructional Design Templates: + +############################## Instructional Design Templates ############################## @@ -10,6 +13,7 @@ Instructional Design Templates .. _LearningOutcomesTemplate: +************************************** Learning Outcome & Alignment Worksheet ************************************** @@ -25,6 +29,7 @@ Filling out the worksheet below will allow you to ensure that your course follow .. _ResourceAnalysisTemplate: +************************** Resource Analysis Template ************************** @@ -37,6 +42,7 @@ A resource, or content, analysis, can help your team discover which pieces of co .. _AudienceAnalysisTemplate: +************************** Audience Analysis Template ************************** @@ -49,6 +55,7 @@ An Audience Analysis outlines who your audience is, their common characteristics .. _CourseOutlineTemplate: +*********************** Course Outline Template *********************** @@ -61,6 +68,7 @@ The course outline is used to track every aspect of the course throughout the va .. _GradingChartTemplate: +************* Grading Chart ************* @@ -73,6 +81,7 @@ Most courses will have a variety of assessments that provide learners multiple o .. _QualityControlTemplate: +************************ Quality Control Template ************************ @@ -85,6 +94,7 @@ In the final stages of the course development process you will need to spend tim .. _CommunicationPlanTemplate: +*************************** Communication Plan Template *************************** @@ -97,6 +107,7 @@ One way to ensure learner engagement is to consistently communicate with your le .. _SupportCalendarTemplate: +************************* Support Calendar Template ************************* @@ -105,4 +116,9 @@ If your team is involved in the delivery of a course, you may want to spend some `Download Support Calendar `_ .. image:: /_images/instructional_design/support_calendar_template.png - :alt: Thumbnail of Downloadable Template for Support Calendar \ No newline at end of file + :alt: Thumbnail of Downloadable Template for Support Calendar + +.. seealso:: + :class: dropdown + + :ref:`Instructional Design Overview` (concept) \ No newline at end of file diff --git a/source/educators/concepts/planning_course_run_information/additional_course_run_information.rst b/source/educators/concepts/planning_course_run_information/additional_course_run_information.rst index 80a43e8e8..47400353a 100644 --- a/source/educators/concepts/planning_course_run_information/additional_course_run_information.rst +++ b/source/educators/concepts/planning_course_run_information/additional_course_run_information.rst @@ -32,4 +32,17 @@ Effort Guidelines ***************** Effort indicates the number of hours each week you expect learners to work on -your course, rounded to the nearest whole number. \ No newline at end of file +your course, rounded to the nearest whole number. + +.. seealso:: + :class: dropdown + + :ref:`Course Dates` (reference) + + :ref:`Scheduling Your Course` (reference) + + :ref:`Set Schedule and Pacing` (how-to) + + :ref:`Setting Course Pacing` (reference) + + :ref:`Course Pacing` (reference) \ No newline at end of file diff --git a/source/educators/how-tos/add_course_creators.rst b/source/educators/how-tos/add_course_creators.rst index 0e05aa514..168c21479 100644 --- a/source/educators/how-tos/add_course_creators.rst +++ b/source/educators/how-tos/add_course_creators.rst @@ -1,3 +1,6 @@ +.. _Add Course Creators: + +################### Add Course Creators ################### diff --git a/source/educators/how-tos/add_image.rst b/source/educators/how-tos/add_image.rst index 4d4e987e9..5c07496d0 100644 --- a/source/educators/how-tos/add_image.rst +++ b/source/educators/how-tos/add_image.rst @@ -1,3 +1,6 @@ +.. _Add an Image: + +############ Add an Image ############ @@ -5,4 +8,15 @@ Add an Image This video will take you through adding images (and text!) to your course: -.. youtube:: -CQekI4-Hjw \ No newline at end of file +.. youtube:: -CQekI4-Hjw + +.. seealso:: + :class: dropdown + + :ref:`Creating a Course About Page` (reference) + + :ref:`Create the Course About Page` (how-to) + + :ref:`Course About Video Guidelines` (reference) + + :ref:`Describe Your Course` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/add_transcript_other_language.rst b/source/educators/how-tos/add_transcript_other_language.rst index 996eb1934..062ff3e5f 100644 --- a/source/educators/how-tos/add_transcript_other_language.rst +++ b/source/educators/how-tos/add_transcript_other_language.rst @@ -1,3 +1,6 @@ +.. _Add Transcript in Another Language: + +#################################### Add a Transcript in Another Language #################################### @@ -5,4 +8,11 @@ Add a Transcript in Another Language Watch this for an overview of how to add a transcript to a video, including different languages: -.. youtube:: qABNazvnAE0 \ No newline at end of file +.. youtube:: qABNazvnAE0 + +.. seealso:: + :class: dropdown + + :ref:`Video Process Overview` (how-to) + + :ref:`Additional Transcript Options` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/add_units.rst b/source/educators/how-tos/add_units.rst index b3bcc67c4..49401cb89 100644 --- a/source/educators/how-tos/add_units.rst +++ b/source/educators/how-tos/add_units.rst @@ -1,3 +1,6 @@ +.. _Add Units to the Outline: + +######################## Add Units to the Outline ######################## diff --git a/source/educators/how-tos/add_video_quiz.rst b/source/educators/how-tos/add_video_quiz.rst index 330ab2fbf..43a2a4b24 100644 --- a/source/educators/how-tos/add_video_quiz.rst +++ b/source/educators/how-tos/add_video_quiz.rst @@ -1,8 +1,26 @@ +.. _Add an In Video Quiz: + +######################## Add an In-Video Quiz -#################### +######################## .. tags:: educator, how-to It's possible to add quizzes directly to a video! Watch this for a how-to: -.. youtube:: 87WT3nGOHwc \ No newline at end of file +.. youtube:: 87WT3nGOHwc + +.. seealso:: + :class: dropdown + + :ref:`Video Process Overview` (how-to) + + :ref:`Introduction to Video` (reference) + + :ref:`Add a Video` (how-to) + + :ref:`Troubleshoot Videos` (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/add_written_content.rst b/source/educators/how-tos/add_written_content.rst index e67460d44..1151af876 100644 --- a/source/educators/how-tos/add_written_content.rst +++ b/source/educators/how-tos/add_written_content.rst @@ -1,3 +1,6 @@ +.. _Add Written Content: + +################### Add Written Content ################### @@ -5,4 +8,9 @@ Add Written Content This video will take you through adding text (and images!) to your course: -.. youtube:: -CQekI4-Hjw \ No newline at end of file +.. youtube:: -CQekI4-Hjw + +.. seealso:: + :class: dropdown + + :ref:`Working with Text Components` (reference) diff --git a/source/educators/how-tos/advanced_features/create_content_for_specific_enrollment_tracks.rst b/source/educators/how-tos/advanced_features/create_content_for_specific_enrollment_tracks.rst index ed04fbf2d..31031f11d 100644 --- a/source/educators/how-tos/advanced_features/create_content_for_specific_enrollment_tracks.rst +++ b/source/educators/how-tos/advanced_features/create_content_for_specific_enrollment_tracks.rst @@ -2,9 +2,9 @@ .. _Enrollment Track Specific Courseware Overview: -####################################################### +###################################################### Create Course Content for Specific Enrollment Tracks -####################################################### +###################################################### .. tags:: educator, how-to diff --git a/source/educators/how-tos/configure_prerequisite_content.rst b/source/educators/how-tos/configure_prerequisite_content.rst index ac5ee4e5a..71dfec1ff 100644 --- a/source/educators/how-tos/configure_prerequisite_content.rst +++ b/source/educators/how-tos/configure_prerequisite_content.rst @@ -1,8 +1,8 @@ .. _configuring_prerequisite_content: -******************************** +################################ Prerequisite Course Subsections -******************************** +################################ .. tags:: educator, how-to @@ -17,9 +17,9 @@ content until they have earned a minimum score in the prerequisite subsection. .. _enabling_subsection_gating: -================================= +******************************** Enable Subsection Prerequisites -================================= +******************************** To enable prerequisite subsections in a course, follow these steps. @@ -31,9 +31,9 @@ To enable prerequisite subsections in a course, follow these steps. .. _creating_a_prerequisite_subsection: -================================== +******************************** Create a Prerequisite Subsection -================================== +******************************** To prevent learners from seeing a subsection of your course until they have earned a minimum score or completed a minimum portion in a prerequisite @@ -115,4 +115,9 @@ subsection, follow these steps. .. note:: Prerequisite course subsection settings are not retained when you :ref:`export or import a course`, or - when you :ref:`re-run a course`. \ No newline at end of file + when you :ref:`re-run a course`. + +.. seealso:: + :class: dropdown + + :ref:`Controlling Content Visibility` (reference) \ No newline at end of file diff --git a/source/educators/how-tos/copy_paste_course_content.rst b/source/educators/how-tos/copy_paste_course_content.rst index ef1b90b57..b7c1b1b2d 100644 --- a/source/educators/how-tos/copy_paste_course_content.rst +++ b/source/educators/how-tos/copy_paste_course_content.rst @@ -1,3 +1,6 @@ +.. _Copy and Paste Course Content: + +############################# Copy and Paste Course Content ############################# @@ -38,4 +41,7 @@ Copy and Paste Course Content in the original. .. seealso:: - :doc:`copy_paste_units` \ No newline at end of file + :class: dropdown + + :ref:`Copy and Paste Course Units ` (how-to) + :ref:`Add Units to the Outline` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/copy_paste_units.rst b/source/educators/how-tos/copy_paste_units.rst index 27e9e167e..4cf5459b1 100644 --- a/source/educators/how-tos/copy_paste_units.rst +++ b/source/educators/how-tos/copy_paste_units.rst @@ -1,3 +1,6 @@ +.. _Copy and Paste Course Units: + +########################### Copy and Paste Course Units ########################### @@ -8,6 +11,7 @@ There are two options for copying and pasting a unit: #. From the Course Outline page #. From the Unit Page +**************************** From the Course Outline page **************************** @@ -33,6 +37,7 @@ From the Course Outline page :alt: The paste button appears in the outline page within a subsection, below the "New Unit" button +****************** From the Unit Page ****************** @@ -79,4 +84,8 @@ From the Unit Page Authors can also paste Units copied from the Unit Page into the Course Outline, and vice versa. .. seealso:: - :doc:`copy_paste_course_content` \ No newline at end of file + :class: dropdown + + :ref:`Copy and Paste Course Content ` (how-to) + + :ref:`Add Units to the Outline` (how-to) \ No newline at end of file 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 6a2ac251e..5a2d1aebe 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 @@ -1,8 +1,8 @@ .. _Add a Video: -======================= +########### Add a Video -======================= +########### .. tags:: educator, how-to @@ -34,3 +34,17 @@ To add a video, follow these steps. #. Optionally, you can set more options for the video. For a description of each option, see :ref:`Video Settings`. +.. seealso:: + :class: dropdown + + :ref:`Video Process Overview` (how-to) + + :ref:`Introduction to Video` (reference) + + :ref:`Troubleshoot Videos` (reference) + + :ref:`Create a Video` (how-to) + + :ref:`Specifying Additional Video Options ` (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/additional_transcript_options.rst b/source/educators/how-tos/course_development/additional_transcript_options.rst index ea8730d86..4fc365ba0 100644 --- a/source/educators/how-tos/course_development/additional_transcript_options.rst +++ b/source/educators/how-tos/course_development/additional_transcript_options.rst @@ -100,4 +100,11 @@ To add another downloadable transcript, follow these steps. #. Create or obtain your transcript as a .pdf or in another format. #. Locate the **Handout** section, and then select **Upload Handout**. #. In the dialog box, select the file on your computer, and then select - **Open**. \ No newline at end of file + **Open**. + +.. seealso:: + :class: dropdown + + :ref:`Video Process Overview` (how-to) + + :ref:`Add Transcript in Another Language` (how-to) \ No newline at end of file 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 1402ce952..09fa4d7a2 100644 --- a/source/educators/how-tos/course_development/additional_video_options.rst +++ b/source/educators/how-tos/course_development/additional_video_options.rst @@ -228,4 +228,19 @@ License The license options that you select control the copyright notice that learners see for the video. For more information, see :ref:`Licensing - a Course`. \ No newline at end of file + a Course`. + +.. seealso:: + :class: dropdown + + :ref:`Video Process Overview` (how-to) + + :ref:`Introduction to Video` (reference) + + :ref:`Add a Video` (how-to) + + :ref:`Troubleshoot Videos` (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 1a4f0572e..d9aea5720 100644 --- a/source/educators/how-tos/course_development/configure_resources.rst +++ b/source/educators/how-tos/course_development/configure_resources.rst @@ -1,23 +1,22 @@ .. _Configure Resources: -************************************ +#################################### Configuring Applications & Resources -************************************ +#################################### .. tags:: educator, how-to As a best practice, you should avoid changing the visibility of your course pages after the course starts. For example, your course includes the Wiki page when it starts. A learner adds a page to the course wiki, -and adds a browser bookmark to that page. If you later hide the Wiki page, the learner’s browser bookmark -will continue to provide access to the entire course wiki. +and adds a browser bookmark to that page. If you later hide the Wiki page, the learner’s browser bookmark will continue to provide access to the entire course wiki. Included below are detailed instructions for the configuration of applications and resources that have additional settings and options. .. _Discussion Configuration: -======================================= +*************************************** Configuring the Discussions application -======================================= +*************************************** There are several configuration options available to the Discussions application. Many basic configuration options are provided within Studio’s Pages & Resources area, and moderation capabilities @@ -32,17 +31,17 @@ To change how the discussion experience is configured, follow these steps: #. Select **Apply** to save your configuration changes. The discussion configuration experience is comprised of two steps: provider selection and provider configuration. -By default, courses are created with the edX discussion experience and its default configuration. +By default, courses are created with the Open edX discussion experience and its default configuration. Other providers and configuration options can be selected to fit the needs of courses. **Step 1: Provider Selection** -In this step, educators can select to use the default edX discussion experience or LTI based integrations with other providers. +In this step, educators can select to use the default Open edX discussion experience or LTI based integrations with other providers. Below the grid of available providers is a table summarizing the features each integration provides. **Step 2: Configuration Options** -Each provider supports its own set of features depending on the discussion features they support. The edX discussion application has various settings and controls that are described below. +Each provider supports its own set of features depending on the discussion features they support. The default Open edX discussion application has various settings and controls that are described below. All integrations use LTI 1.1 configuration, and may additionally support platform settings from the list below. Any special instructions or details specific to a given provider are described in this step as well. **Anonymous Posting** @@ -64,9 +63,9 @@ Course teams can specify one or multiple times during which the discussion forum .. _Wiki Configuration: -================================ +******************************** Configuring the Wiki application -================================ +******************************** For instructions on how to enable the wiki application see :ref:`11.3.2.3 Enabling the Wiki Application`. @@ -81,24 +80,24 @@ To change access to the course wiki, follow these steps. #. Select **Apply** to save your configuration changes. The **Enable public wiki** access wiki setting is disabled by default, meaning that only course team members and -enrolled learners can see the course wiki. If you enable this setting, then any registered edX user can access the +enrolled learners can see the course wiki. If you enable this setting, then any registered user on your site can access the course wiki, even if they are not enrolled in your course. However, public users would have to explicitly navigate -to your wiki via the edX-wide wiki structure, or a link that has been provided to them. +to your wiki via the site-wide wiki structure, or a link that has been provided to them. .. _Teams Configuration: -================================= +********************************** 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`. .. _ORA Coursewide Settings: -=========================================================== +********************************************************** Configuring Course-level Open Response Assessment Settings -=========================================================== +********************************************************** To simplify the management of Open Response Assessment (ORA) problems, a card on this page provides a way to enable certain course-wide overrides. Rather than going through each ORA in a course individually, these overrides allow @@ -114,4 +113,12 @@ To learn about Flexible Peer Grading and the course override setting, see :ref: .. seealso:: :class: dropdown - :ref:`Adding Pages to a Course` (how to) \ No newline at end of file + :ref:`Adding Pages to a Course` (how to) + + :ref:`Discussions` (concept) + + :ref:`About Course Wiki` (reference) + + :ref:`Teams Overview ` (concept) + + :ref:`Open Response Assessments` (concept) \ No newline at end of file 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 25a02443a..25b0a4d03 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 @@ -1,8 +1,8 @@ .. _Create a Subsection: -**************************** +################### Create a Subsection -**************************** +################### .. tags:: educator, how-to @@ -110,4 +110,41 @@ To delete a subsection, follow these steps. circled. #. When the confirmation prompt appears, select **Yes, delete this - subsection**. \ No newline at end of file + subsection**. + +.. seealso:: + :class: dropdown + + :ref:`Getting Started with Course Content Development` (reference) + + :ref:`Course Outline` (concept) + + :ref:`Creating a New Course` (how-to) + + :ref:`Create the Course About Page` (how-to) + + :ref:`Understanding Your Course Outline` (reference) + + :ref:`Add Content in the Course Outline` (reference) + + :ref:`Developing Your Course Outline` (reference) + + :ref:`Modify Settings for Objects in the Course Outline` (reference) + + :ref:`Publish Content from the Course Outline` (reference) + + :ref:`Developing Course Sections` (reference) + + :ref:`Developing Course Subsections` (reference) + + :ref:`Create a Section` (how-to) + + :ref:`Hide a Subsection from Students` (how-to) + + :ref:`Add Course Metadata` (how-to) + + :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` (reference) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/exercise_tools/create_iframe.rst b/source/educators/how-tos/course_development/exercise_tools/create_iframe.rst index 546a6caea..1d74b19b7 100644 --- a/source/educators/how-tos/course_development/exercise_tools/create_iframe.rst +++ b/source/educators/how-tos/course_development/exercise_tools/create_iframe.rst @@ -1,8 +1,8 @@ .. _Create IFrame: -********************* +##################### Create an IFrame Tool -********************* +##################### .. tags:: educator, how-to @@ -50,9 +50,9 @@ component. You can also add text and images both before and after the iframe. .. _IFrame Settings: -=============== +*************** Iframe Settings -=============== +*************** To specify settings for your iframe, you add, remove, or change the attributes inside the opening ``