From c93aca202a4111c6a6df32a6694b33244a8b4040 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 11:59:07 -0500 Subject: [PATCH 01/16] docs: update 'using_openedx_as_LTI_provider.rst' file --- .../using_openedx_as_LTI_provider.rst | 34 +++++++++---------- 1 file changed, 16 insertions(+), 18 deletions(-) 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..626296456 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 @@ -1,47 +1,45 @@ .. _Using Open edX as an LTI Tool Provider: -####################################### Using Open edX as an LTI Tool Provider -####################################### +###################################### .. tags:: educator, concept .. note:: This feature was a closed pilot experiment. This feature is not supported for new users. -An experimental feature enabled the edX Edge site to be configured to be a -learning tool interoperability (LTI) provider to other systems and applications +An experimental feature enabled the Open edX Edge site to be configured to be a +learning tool interoperability (LTI) provider to other systems and applications that partner institutions use. After initial configuration and testing between Edge and your system or application is complete, course teams could use this feature to reuse Edge course content, including advanced problem types and videos, in an on campus or in house learning management system. Examples currently include courses running on Canvas and Blackboard. -You can also include content from an LTI provider in your edX courses. For +You can also include content from an LTI provider in your Open edX courses. For more information, see :ref:`LTI Component`. .. _Grading Remote Content: -****************************** Grading Remote Content -****************************** +********************** .. note:: This feature was a closed pilot experiment. This feature is not supported for new users. -When you include the problem components in a graded edX subsection in an -external LMS, the edX system grades the learner responses to those problems. -The edX system then transfers the learner scores back to the external LMS. This -exchange between an external LMS, the edX system, and the external LMS again is -near real time. It can take a few moments to complete this exchange for a -single problem component, and up to several minutes to return aggregated scores -of all of the problems in a unit or subsection. +When you include the problem components in a graded Open edX subsection in an +external LMS, the Open edX system grades the learner responses to those +problems. The Open edX system then transfers the learner scores back to the +external LMS. This exchange between an external LMS, the Open edX system, and +the external LMS again is near real time. It can take a few moments to complete +this exchange for a single problem component, and up to several minutes to +return aggregated scores of all of the problems in a unit or subsection. -When you include edX problem components in an external LMS, note the following -requirements. +When you include Open edX problem components in an external LMS, note the +following requirements. -* The edX problem component must be in one of the graded subsections in your - course. +* The Open edX problem component must be in one of the graded subsections in + your course. * Your external LMS might also require that you use a specific part of the course for graded content. For example, in Canvas, you must add the LTI URL From 4ed06109fe3b34346b13f3a495712ebda9297d6c Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 12:06:02 -0500 Subject: [PATCH 02/16] docs: update 'lti_reuse_content.rst' file --- .../advanced_features/lti_reuse_content.rst | 98 ++++++++++--------- 1 file changed, 53 insertions(+), 45 deletions(-) diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst index 7ad3d0ab7..0fd709dac 100644 --- a/source/educators/concepts/advanced_features/lti_reuse_content.rst +++ b/source/educators/concepts/advanced_features/lti_reuse_content.rst @@ -1,34 +1,31 @@ .. _Reusing Course Content: -########################################## Reusing Course Content with LTI -########################################## +############################### .. tags:: educator, concept -.. only:: Partners - .. note:: This feature was a closed pilot experiment. This feature is not supported for new users. -When you use LTI to reuse edX course content, learners who are already familiar -with an external learning management system or other consumer application -(external LMS) see content from edX that is seamlessly integrated into a -familiar context. Only the content that you specify from edX appears in the -external LMS, typically within an iframe on a page. +When you use LTI to reuse Open edX course content, learners who are already +familiar with an external learning management system or other consumer +application (external LMS) see content from Open edX that is seamlessly +integrated into a familiar context. Only the content that you specify from Open +edX appears in the external LMS, typically within an iframe on a page. For example, you can set up a course on an external LMS, such as Canvas, to -include a link to a problem component that is part of an edX course. The +include a link to a problem component that is part of an Open edX course. The problem is included as one of the course's assignments, and appears in Canvas like other content. .. image:: /_images/educator_concepts/lti_canvas_example.png - :alt: An edX molecule builder problem shown as part of a course running on a - Canvas system. + :alt: An Open edX molecule builder problem shown as part of a course running + on a Canvas system. This section provides background information on different aspects of the -experience that learners and course team members have when interacting with edX -content in the context of an external LMS. +experience that learners and course team members have when interacting with +Open edX content in the context of an external LMS. .. contents:: :local: @@ -37,56 +34,67 @@ content in the context of an external LMS. For information about the content that you can include in an external LMS, see :ref:`Preparing Content`. -********************************** Course Roster Management -********************************** +************************ Course teams manage the course roster entirely on the external LMS, as you -would for other courses that run on that platform. Learners do not use the edX -LMS to enroll, and the course team does not complete any enrollment activities -in Studio or the edX LMS. +would for other courses that run on that platform. Learners do not use the Open +edX LMS to enroll, and the course team does not complete any enrollment +activities in Studio or the Open edX LMS. To obtain enrollment data for the course, you use the features available in the external LMS. -****************************************** Learner Identification and Single Sign On -****************************************** - -.. only:: Partners +***************************************** .. note:: Different configuration options are available for how an external - LMS and edX Edge authenticate users. Your DevOps team is likely to have + LMS and Open edX Edge authenticate users. Your DevOps team is likely to have additional information about the specific authentication process used by your institution. Learners do not need to navigate to a different website, or sign in to any -other system (including edX), to access content that originates in an edX -course. However, the first time a learner views edX course content in the -external LMS, she might have to re-enter her credentials for the external LMS, -even though she is already signed in to the external LMS. - -Internally, the edX instance associates a unique internal identifier to each -learner's credentials to allow for a streamlined, single sign in experience in -the future. However, this separate edX identifier can make some edX content -confusing for learners when viewed in the context of an external LMS. For -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. +other system (including Open edX), to access content that originates in an Open +edX course. However, the first time a learner views Open edX course content in +the external LMS, she might have to re-enter her credentials for the external +LMS, even though she is already signed in to the external LMS. + +Internally, the Open edX instance associates a unique internal identifier to +each learner's credentials to allow for a streamlined, single sign in +experience in the future. However, this separate Open edX identifier can make +some Open edX content confusing for learners when viewed in the context of an +external LMS. For example, Open edX course discussions can identify +participants by their Open edX IDs instead of the usernames they would normally +see in the external LMS. As a result, some Open edX content is not currently +suitable for use in an external LMS. For more information, see :ref:`Preparing Content`. -****************************** Learner Progress and Grades -****************************** +*************************** -Each learner's progress through the edX content is saved. Learners start, stop, -and resume work in the external LMS in the same way that they would in the edX -LMS. +Each learner's progress through the Open edX content is saved. Learners start, +stop, and resume work in the external LMS in the same way that they would in +the Open edX LMS. -Learner responses to edX problem components are graded by the edX system, and -then transferred automatically to the grade book in the external LMS. For more -information, see :ref:`Grading Remote Content`. +Learner responses to Open edX problem components are graded by the Open edX +system, and 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. \ No newline at end of file +available in the external LMS. + +.. seealso:: + :class: dropdown + + :doc: `using_openedx_as_LTI_provider` (concept) + + :doc: `/how-tos/advanced_features/lti_prepare_content` (how-to) + + :doc: `/how-tos/advanced_features/lti_determine_content_address` (how-to) + + :doc: `/references/advanced_features/planning_content_reuse` (reference) + + :doc: `/references/advanced_features/lti_canvas_example` (reference) + + :doc: `/references/advanced_features/lti_blackboard_example` (reference) From 0a04b62f2537b0f57839431cd97a35402e627ad4 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 12:14:19 -0500 Subject: [PATCH 03/16] docs: update 'teams_overview.rst' file --- source/educators/concepts/advanced_features/teams_overview.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/educators/concepts/advanced_features/teams_overview.rst b/source/educators/concepts/advanced_features/teams_overview.rst index ea251c25f..b280e9935 100644 --- a/source/educators/concepts/advanced_features/teams_overview.rst +++ b/source/educators/concepts/advanced_features/teams_overview.rst @@ -1,8 +1,7 @@ .. _CA_Teams_Overview: -*************** Teams Overview -*************** +############## .. tags:: educator, concept From a9c26484a5c13f67b55ac89e44cf9db543a29b02 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 12:20:13 -0500 Subject: [PATCH 04/16] docs: update 'managing_teams_discussions.rst' file --- .../managing_teams_discussions.rst | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/source/educators/concepts/advanced_features/managing_teams_discussions.rst b/source/educators/concepts/advanced_features/managing_teams_discussions.rst index ca16a3781..d0d7e7ad5 100644 --- a/source/educators/concepts/advanced_features/managing_teams_discussions.rst +++ b/source/educators/concepts/advanced_features/managing_teams_discussions.rst @@ -1,18 +1,17 @@ .. _Teams Discussions: - -######################### -Managing Team Discussions -######################### +Managing Teams Discussions +########################## .. tags:: educator, concept -EdX recommends that you designate course staff and optionally student teaching -assistants (TAs) to moderate team discussions. The same discussion -administration roles for managing course discussions on the **Discussions** page -apply to discussion administration for team discussions. Course team members and -student TAs who already have discussion moderation roles for course discussions -on the **Discussions** page can perform the same roles for discussions in teams. +Open EdX recommends that you designate course staff and optionally student +teaching assistants (TAs) to moderate team discussions. The same discussion +administration roles for managing course discussions on the **Discussions** +page apply to discussion administration for team discussions. Course team +members and student TAs who already have discussion moderation roles for course +discussions on the **Discussions** page can perform the same roles for +discussions in teams. For information about discussion administration roles, see :ref:`Assigning_discussion_roles`. For information about managing discussions, @@ -22,7 +21,6 @@ see :ref:`Running_discussions`. :local: :depth: 1 -*********************************** Ability to Post in Team Discussions *********************************** @@ -35,9 +33,8 @@ Posts made by discussion community TAs are marked with a **Community TA** label in the discussion navigation pane, and those made by discussion moderators or discussion admins are marked with a **Staff** label. -*********************************** Ability to Edit or Delete Posts -*********************************** +******************************* Discussion moderators, discussion admins, and community TAs can perform the following actions in team discussions, without being a member of the team. From 5a74d8d9b4cddd3f565ee023115ea882889aea90 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 12:52:37 -0500 Subject: [PATCH 05/16] docs: update 'teams_learner_experience.rst' file --- .../teams_learner_experience.rst | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/source/educators/concepts/advanced_features/teams_learner_experience.rst b/source/educators/concepts/advanced_features/teams_learner_experience.rst index 7c56fa9e0..f4e0987a6 100644 --- a/source/educators/concepts/advanced_features/teams_learner_experience.rst +++ b/source/educators/concepts/advanced_features/teams_learner_experience.rst @@ -1,9 +1,7 @@ .. _CA Learner Experience of Teams: - -########################################## The Learner's Experience of Teams -########################################## +################################# .. tags:: educator, concept @@ -15,15 +13,13 @@ within topics. Each learner can belong to only one team. :local: :depth: 1 -*********************************** Browsing Teams by Topic -*********************************** +*********************** On the **Teams** page in the LMS, learners in your course can browse topics to find a subject that they are interested in collaborating on. Learners can sort topics alphabetically by name, or by the number of teams in a topic. - .. image:: /_images/educator_concepts/Teams_TopicArrowButton.png :width: 500 :alt: On the page showing available topics, one topic has the arrow button @@ -51,10 +47,8 @@ identify with. While they are browsing teams, learners can read any team's discussion posts, but they cannot add posts to a team's discussion forum unless they join that team. - -************************************* Joining, Creating, or Leaving a Team -************************************* +************************************ When learners find a team that they want to join, they select **Join Team** and are immediately added to the team membership. @@ -76,8 +70,8 @@ Learners specify a name and description for their team, and optionally specify a country and language that team members identify with. A learner who creates a team automatically becomes a member of the new team. -.. note:: EdX recommends that you encourage learners to join existing teams - before they create new teams. +.. note:: Open EdX recommends that you encourage learners to join existing + teams before they create new teams. .. note:: Because course staff who have the role of Admin, Discussion Moderator, or Discussion Admin can create multiple teams, these course staff are not @@ -92,10 +86,8 @@ they have left. .. Add back Invite Others when available - -************************************* Participating in Team Discussions -************************************* +********************************* Only members of a team (or anyone with a discussion administrator, discussion moderator, or community TA role) can post to a team's discussion forum. Any From 8839aaf65a3a6f21f229c8b57bb7f6b0c375e27e Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 14:53:51 -0500 Subject: [PATCH 06/16] docs: update 'drag_and_drop.rst' file --- source/educators/concepts/exercise_tools/drag_and_drop.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/source/educators/concepts/exercise_tools/drag_and_drop.rst b/source/educators/concepts/exercise_tools/drag_and_drop.rst index 7e6c4f7ea..59bae6e86 100644 --- a/source/educators/concepts/exercise_tools/drag_and_drop.rst +++ b/source/educators/concepts/exercise_tools/drag_and_drop.rst @@ -1,6 +1,5 @@ .. _drag_and_drop_problem: -##################### Drag and Drop Problem ##################### @@ -23,7 +22,6 @@ to use drag and drop problems in your course. .. _overview_of_drag_and_drop_problems: -********************************** Overview of Drag and Drop Problems ********************************** @@ -94,10 +92,9 @@ message informs the learner that the problem is complete. :alt: An example of a simple drag and drop problem. The problem is complete and the final feedback message appears below the background image. - .. seealso:: :class: dropdown - :ref:`Creating a Drag and Drop Problem` (how to) + :ref:`Creating a Drag and Drop Problem` (how-to) :ref:`Drag and Drop` (reference) From 631efb0c2943fbc66ace9421effc728bd39622c7 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 15:07:36 -0500 Subject: [PATCH 07/16] docs: update 'external_graders.rst' file --- .../concepts/exercise_tools/external_graders.rst | 16 +++++----------- source/links.txt | 2 +- 2 files changed, 6 insertions(+), 12 deletions(-) diff --git a/source/educators/concepts/exercise_tools/external_graders.rst b/source/educators/concepts/exercise_tools/external_graders.rst index 3bfee3f7d..3e6d6becd 100644 --- a/source/educators/concepts/exercise_tools/external_graders.rst +++ b/source/educators/concepts/exercise_tools/external_graders.rst @@ -1,8 +1,7 @@ .. _External Grader: -########################### External Grader -########################### +############### .. tags:: educator, concept @@ -22,9 +21,8 @@ For more information, see the following sections. .. _External Grader Workflow: -************************** External Grader Workflow -************************** +************************ XQueue uses the following workflow for external grader problems. @@ -38,14 +36,13 @@ XQueue uses the following workflow for external grader problems. #. The XQueue delivers the results to the LMS. #. In the LMS, the learner sees the problem results and the grade. -For the code for the XQueue interface, see the ``urls.py`` file in the `edX -XQueue repository`_. +For the code for the XQueue interface, see the ``urls.py`` file in the `Open +edX XQueue repository`_. .. _External Grader Example: -*************************** External Grader Example -*************************** +*********************** An external grader is particularly useful for software programming courses where learners are asked to submit complex code. The grader can run tests that @@ -61,15 +58,12 @@ full output**. A message can be useful when the learner's solution is not correct and you want to return information about the failed tests, as in the following example. - .. image:: /_images/educator_concepts/external-grader.png :alt: A learner's view of a programming problem that uses an external grader, with an incorrect result. - .. _External Grader Requirements: -============================ External Grader Requirements ============================ diff --git a/source/links.txt b/source/links.txt index df5f72d7e..e33f19fb4 100644 --- a/source/links.txt +++ b/source/links.txt @@ -610,7 +610,7 @@ .. _XQueue: https://github.com/openedx/xqueue -.. _edX XQueue repository: https://github.com/openedx/xqueue/blob/master/queue +.. _Open edX XQueue repository: https://github.com/openedx/xqueue/tree/master/xqueue .. _GnuPG website: https://www.gnupg.org From 9c7990bb9fa5a4ffaf624779eee712da1e3edcac Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 15:17:07 -0500 Subject: [PATCH 08/16] docs: update 'create_exercises.rst' file --- .../concepts/exercise_tools/create_exercises.rst | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/source/educators/concepts/exercise_tools/create_exercises.rst b/source/educators/concepts/exercise_tools/create_exercises.rst index f366ef3e6..8d120bbf6 100644 --- a/source/educators/concepts/exercise_tools/create_exercises.rst +++ b/source/educators/concepts/exercise_tools/create_exercises.rst @@ -1,22 +1,20 @@ .. _Create Exercises: -############################## Problems, Exercises, and Tools ############################## .. tags:: educator, concept -You can add a wide variety of different types of problems, exercises, and -tools to your course outline. By default, a core set of :ref:`problem -types` is available in Studio for you to -include in your course. You have the option to expand the initial set of core -problem types by enabling additional exercises and tools. +You can add a variety of problems, exercises, and tools to your course outline. +By default, a core set of :ref:`problem types` +is available in Studio for you to include in your course. You have the option +to expand the initial set of core problem types by enabling additional +exercises and tools. .. contents:: :local: :depth: 2 -********************************************************* Enhancing Your Course with Additional Exercises and Tools ********************************************************* @@ -42,6 +40,6 @@ selection of other exercises and tools that you can add to your course. .. seealso:: :class: dropdown - :ref:`Core Problem Types` (reference) + :ref: `Core Problem Types` (reference) - :ref:'Enable Additional Exercises and Tools' (how to) + :ref: `Enable Additional Exercises and Tools` (how-to) From 5551fc87ec449eac67b12c51da744050d40d8262 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Mon, 30 Dec 2024 17:38:32 -0500 Subject: [PATCH 09/16] docs: update 'OpenResponseAssessments.rst' file --- .../OpenResponseAssessments.rst | 97 +++++++------------ 1 file changed, 37 insertions(+), 60 deletions(-) diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index 19344a34c..c7ba22d01 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -1,8 +1,7 @@ .. _Open Response Assessments: -########################################### Introduction to Open Response Assessments -########################################### +######################################### .. tags:: educator, concept @@ -37,9 +36,8 @@ including step by step instructions, see the following sections. .. _PA Elements: -****************************************** Elements of an Open Response Assessment -****************************************** +*************************************** When you create an open response assessment assignment, you include several elements. @@ -63,7 +61,6 @@ For step-by-step instructions for creating an open response assessment, see .. _PA Prompts: -======= Prompts ======= @@ -85,7 +82,6 @@ where learners enter their responses. For more information, see .. _PA Rubric: -======= Rubric ======= @@ -158,7 +154,7 @@ For information about creating a rubric, see :ref:`PA Add Rubric`. An Example Criterion -***************************** +******************** In a rubric, one criterion and its set of options might resemble the following. @@ -201,9 +197,8 @@ points possible) .. _PA Assessment Steps: -================= Assessment Steps -================= +================ In your assignment, you also specify the **assessment steps**. You can set the assignment to include some combination of the following steps. @@ -214,10 +209,10 @@ assignment to include some combination of the following steps. .. note:: If you include a learner training step, you must also include a peer assessment step. The learner training step must come before peer or self - assessment steps. If you include both peer and self assessment steps, edX - recommends that you place the peer assessment before the self assessment. - If you include a staff assessment step, it should be the final step in the - assignment. + assessment steps. If you include both peer and self assessment steps, Open + edX recommends that you place the peer assessment before the self + assessment. If you include a staff assessment step, it should be the final + step in the assignment. You can see the type and order of the assessments when you look at the assignment. In the following example, after learners submit their responses, they @@ -232,7 +227,7 @@ a self assessment ("Assess Your Response"). .. _PA Student Training Step: Learner Training Step -***************************** +********************* Learner training steps teach learners to perform their own assessments. A learner training assessment contains one or more sample responses that you @@ -272,22 +267,21 @@ For more information, see :ref:`PA Student Training`. .. _Peer Assessment Step: Peer Assessment Step -***************************** +******************** In the peer assessment step, learners review the responses of other learners in the course. For each response, they select an option for each criterion in your rubric based on the response. Learners can also provide text feedback, or comments, on each response. -If you include both peer and self assessment steps, edX recommends that you -place the peer assessment before the self assessment. +If you include both peer and self assessment steps, Open edX recommends that +you place the peer assessment before the self assessment. For information about how peer assessments affect a learner's assignment grade, see :ref:`PA Scoring`. - Number of Responses and Assessments -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +=================================== When you include a peer assessment step, you specify the number of responses that each learner must assess (**Must Grade**) and the number of peer @@ -312,7 +306,7 @@ do not count toward the score that the response receives. .. _Feedback Options: Feedback Options -^^^^^^^^^^^^^^^^ +================ By default, in peer assessment steps, learners can provide text feedback for the entire response, using a single comment field below the entire rubric. You @@ -327,7 +321,7 @@ Field Only`. Assessing Additional Responses -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +============================== Learners can assess more than the required number of responses. After a learner completes the peer assessment step, the step "collapses" so that only @@ -337,24 +331,22 @@ If the learner selects the **Assess Peers** heading, the step expands again. The learner can then select **Continue Assessing Peers** to perform additional peer assessments. - .. _Self Assessment Step: Self Assessment Step -***************************** +******************** In self assessment steps, the learner sees her own response followed by the rubric. As with peer assessments, the learner evaluates the response using the rubric, selecting an option for each criterion. -If you include both peer and self assessments, edX recommends that you include -the peer assessment before the self assessment. - +If you include both peer and self assessments, Open edX recommends that you +include the peer assessment before the self assessment. .. _Staff Assessment Step: Staff Assessment Step -***************************** +********************* In staff assessment steps, a member of the course team performs an evaluation of the learner's response. Course team members grade the response using the @@ -379,10 +371,8 @@ course experiences for learners in different cohorts, see For details about performing grading in staff assessment steps, see :ref:`Perform a Staff Assessment`. - .. _PA Scoring: -******************************************************* How Scores for Open Response Assessments Are Calculated ******************************************************* @@ -401,15 +391,13 @@ assessment portions independently. In open response assessments that include only self assessments, the assignment's final score is equivalent to the self assessment score. -.. note:: Given the high level of subjectivity in peer assessments, edX +.. note:: Given the high level of subjectivity in peer assessments, Open edX recommends that you make ORA assignments count towards only a small percentage of a course's final grade. The following topics detail how the scores for peer assessments and self assessments are calculated. - -======================= Peer Assessment Scoring ======================= @@ -511,8 +499,6 @@ Then set the toggle for this feature on or off :alt: Image highlighting the toggle for flexible peer grading on the course level :width: 600 - -======================= Self Assessment Scoring ======================= @@ -527,7 +513,6 @@ Self assessments are scored by criteria. Each learner rates herself on each criterion, using the rubric. The learner's final score on a response is the total number of earned points, out of the total possible points. -======================== Staff Assessment Scoring ======================== @@ -537,9 +522,8 @@ assignment. .. _PA Top Responses: -***************************** Top Responses -***************************** +************* You can include a **Top Responses** section that shows the top scoring responses that learners have submitted for the assignment, along with the @@ -555,7 +539,7 @@ assignment. You can allow the **Top Responses** section to show between 1 and 100 responses. Keep in mind, however, that each response might be up to 300 pixels in height in the list. (For longer responses, learners can scroll to see the -entire response.) EdX recommends that you specify 20 or fewer responses to +entire response.) Open edX recommends that you specify 20 or fewer responses to prevent the page from becoming too long. .. note:: It can take up to an hour for a high-scoring response to appear in the @@ -567,12 +551,10 @@ prevent the page from becoming too long. For more information, see :ref:`PA Show Top Responses`. - .. _Best Practices for ORA: -********************************************* Best Practices for Open Response Assessments -********************************************* +******************************************** Open response assessments can be a powerful teaching tool, but they are more effective in some situations than in others. In general, open response @@ -586,12 +568,11 @@ correct or incorrect answers to questions. .. note:: Do not add more than one ORA component in a course unit. Multiple ORA assignments in a unit cause errors when learners submit their assessments. -EdX suggests that you follow the guidelines and best practices in the +Open edX suggests that you follow the guidelines and best practices in the following sections when you use open response assessments in your courses. -========================= Designing the Assignment -========================= +======================== * Do not add more than one ORA component in a course unit. Multiple ORA assignments in a unit cause errors when learners submit their assessments. @@ -607,9 +588,8 @@ Designing the Assignment containing the staff assessment step available only to members of one or more cohorts. -==================== Grading and Rubrics -==================== +=================== * Make sure you have a well designed and clear :ref:`rubric ` for the assignment. A good rubric is very important in helping to eliminate @@ -629,12 +609,11 @@ Grading and Rubrics * Consider using ungraded ORA assignments to generate learner interaction and feedback without affecting grades. -========================= Peer Assessments -========================= +================ * Set the **Must Grade** number higher than the **Graded By** number to - minimize the chance that some responses will not be peer assessed. EdX + minimize the chance that some responses will not be peer assessed. Open edX recommends a setting such as **Must Grade** = 4 and **Graded By** = 3. * To allow enough time for peer assessments to be performed after learners @@ -665,9 +644,8 @@ Peer Assessments .. _Asking Learners to Upload Other Files in Responses: -******************************************************* Asking Learners to Upload Files in Responses -******************************************************* +******************************************** In ORA assignments, you can ask your learners to upload images, .pdf files, or other types of files as a part of their responses. Other learners @@ -697,16 +675,15 @@ For more information, see :ref:`PA Allow Images`. .. _Prohibited File Extensions: -========================== Prohibited File Extensions ========================== Learners cannot upload file types that have the following file name extensions -as part of an open response assessment on edx.org or edX Edge. When you define -a set of custom file types for learners to upload with their responses, you -cannot specify these file types. The extensions on this list are selected and -maintained by the development operations team at edX, and are subject to -change. +as part of an open response assessment on openedx.org or Open edX Edge. When +you define a set of custom file types for learners to upload with their +responses, you cannot specify these file types. The extensions on this list are +selected and maintained by the development operations team at Open edX, and are +subject to 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 @@ -731,10 +708,10 @@ information, see .. seealso:: :class: dropdown - :ref:`PA Create an ORA Assignment` (how to) + :ref:`PA Create an ORA Assignment` (how-to) - :ref:`Managing ORA Assignments` (how to) + :ref:`Managing ORA Assignments` (how-to) :ref:`ORA Staff Grading` (reference) - :ref:`Accessing ORA Assignment Information` (reference) \ No newline at end of file + :ref:`Accessing ORA Assignment Information` (reference) From 9eac14cba391cac766736a715e25b8cdbc112026 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Wed, 8 Jan 2025 17:42:23 -0500 Subject: [PATCH 10/16] chore: address PR review --- .../advanced_features/lti_reuse_content.rst | 38 ++++++++---------- .../managing_teams_discussions.rst | 14 +++---- .../teams_learner_experience.rst | 4 +- .../using_openedx_as_LTI_provider.rst | 25 +++++------- .../OpenResponseAssessments.rst | 39 ++++++++++--------- 5 files changed, 54 insertions(+), 66 deletions(-) diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst index 0fd709dac..c7a0a4f94 100644 --- a/source/educators/concepts/advanced_features/lti_reuse_content.rst +++ b/source/educators/concepts/advanced_features/lti_reuse_content.rst @@ -5,19 +5,17 @@ Reusing Course Content with LTI .. tags:: educator, concept -.. note:: This feature was a closed pilot experiment. This feature is not - supported for new users. - -When you use LTI to reuse Open edX course content, learners who are already +When you use LTI to reuse your course content, learners who are already familiar with an external learning management system or other consumer -application (external LMS) see content from Open edX that is seamlessly -integrated into a familiar context. Only the content that you specify from Open -edX appears in the external LMS, typically within an iframe on a page. +application (external LMS) see content from your Open edX instance that is +seamlessly integrated into a familiar context. Only the content that you +specify from your Open edX instance appears in the external LMS, typically +within an iframe on a page. For example, you can set up a course on an external LMS, such as Canvas, to -include a link to a problem component that is part of an Open edX course. The -problem is included as one of the course's assignments, and appears in Canvas -like other content. +include a link to a problem component that is part of a course on your +instance. The problem is included as one of the course's assignments, and +appears in Canvas like other content. .. image:: /_images/educator_concepts/lti_canvas_example.png :alt: An Open edX molecule builder problem shown as part of a course running @@ -48,23 +46,19 @@ the external LMS. Learner Identification and Single Sign On ***************************************** - .. note:: Different configuration options are available for how an external - LMS and Open edX Edge authenticate users. Your DevOps team is likely to have - additional information about the specific authentication process used by - your institution. - Learners do not need to navigate to a different website, or sign in to any -other system (including Open edX), to access content that originates in an Open -edX course. However, the first time a learner views Open edX course content in -the external LMS, she might have to re-enter her credentials for the external -LMS, even though she is already signed in to the external LMS. +other system (including your Open edX instance), to access content that +originates in an course in your instance. However, the first time a learner +views Open edX course content in the external LMS, she might have to re-enter +her credentials for the external LMS, even though she is already signed in to +the external LMS. Internally, the Open edX instance associates a unique internal identifier to each learner's credentials to allow for a streamlined, single sign in -experience in the future. However, this separate Open edX identifier can make -some Open edX content confusing for learners when viewed in the context of an +experience in the future. However, this separate identifier can make +some content confusing for learners when viewed in the context of an external LMS. For example, Open edX course discussions can identify -participants by their Open edX IDs instead of the usernames they would normally +participants by these unique IDs instead of the usernames they would normally see in the external LMS. As a result, some Open edX content is not currently suitable for use in an external LMS. diff --git a/source/educators/concepts/advanced_features/managing_teams_discussions.rst b/source/educators/concepts/advanced_features/managing_teams_discussions.rst index d0d7e7ad5..3ef0636f7 100644 --- a/source/educators/concepts/advanced_features/managing_teams_discussions.rst +++ b/source/educators/concepts/advanced_features/managing_teams_discussions.rst @@ -5,13 +5,13 @@ Managing Teams Discussions .. tags:: educator, concept -Open EdX recommends that you designate course staff and optionally student -teaching assistants (TAs) to moderate team discussions. The same discussion -administration roles for managing course discussions on the **Discussions** -page apply to discussion administration for team discussions. Course team -members and student TAs who already have discussion moderation roles for course -discussions on the **Discussions** page can perform the same roles for -discussions in teams. +The Open EdX community recommends that you designate course staff and +optionally student teaching assistants (TAs) to moderate team discussions. The +same discussion administration roles for managing course discussions on the +**Discussions** page apply to discussion administration for team discussions. +Course team members and student TAs who already have discussion moderation +roles for course discussions on the **Discussions** page can perform the same +roles for discussions in teams. For information about discussion administration roles, see :ref:`Assigning_discussion_roles`. For information about managing discussions, diff --git a/source/educators/concepts/advanced_features/teams_learner_experience.rst b/source/educators/concepts/advanced_features/teams_learner_experience.rst index f4e0987a6..a9ba95bd0 100644 --- a/source/educators/concepts/advanced_features/teams_learner_experience.rst +++ b/source/educators/concepts/advanced_features/teams_learner_experience.rst @@ -70,8 +70,8 @@ Learners specify a name and description for their team, and optionally specify a country and language that team members identify with. A learner who creates a team automatically becomes a member of the new team. -.. note:: Open EdX recommends that you encourage learners to join existing - teams before they create new teams. +.. note:: The recommendation is to encourage learners to join existing teams + before they create new teams. .. note:: Because course staff who have the role of Admin, Discussion Moderator, or Discussion Admin can create multiple teams, these course staff are not 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 626296456..8e60c577c 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 @@ -5,27 +5,16 @@ Using Open edX as an LTI Tool Provider .. tags:: educator, concept -.. note:: This feature was a closed pilot experiment. This feature is not - supported for new users. - -An experimental feature enabled the Open edX Edge site to be configured to be a -learning tool interoperability (LTI) provider to other systems and applications -that partner institutions use. After initial configuration and testing between -Edge and your system or application is complete, course teams could use this -feature to reuse Edge course content, including advanced problem types and -videos, in an on campus or in house learning management system. Examples -currently include courses running on Canvas and Blackboard. - -You can also include content from an LTI provider in your Open edX courses. For -more information, see :ref:`LTI Component`. +You can also include content from an LTI provider in your courses. For more +information, see :ref:`LTI Component`. .. _Grading Remote Content: Grading Remote Content ********************** -.. note:: This feature was a closed pilot experiment. This feature is not - supported for new users. +.. warning:: This feature was a closed pilot experiment. This feature is poorly + documented and may not work properly. When you include the problem components in a graded Open edX subsection in an external LMS, the Open edX system grades the learner responses to those @@ -62,4 +51,8 @@ For more information about constructing an LTI URL for a course component, see :ref:`Example: 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) + + :ref: `edX as an LTI Provider to Canvas` (reference) + + :ref: `edX as an LTI Provider to Blackboard` (reference) diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index c7ba22d01..921c9a008 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -274,8 +274,8 @@ in the course. For each response, they select an option for each criterion in your rubric based on the response. Learners can also provide text feedback, or comments, on each response. -If you include both peer and self assessment steps, Open edX recommends that -you place the peer assessment before the self assessment. +If you include both peer and self assessment steps, the Open edX Community +recommends that you place the peer assessment before the self assessment. For information about how peer assessments affect a learner's assignment grade, see :ref:`PA Scoring`. @@ -340,8 +340,8 @@ In self assessment steps, the learner sees her own response followed by the rubr As with peer assessments, the learner evaluates the response using the rubric, selecting an option for each criterion. -If you include both peer and self assessments, Open edX recommends that you -include the peer assessment before the self assessment. +If you include both peer and self assessments, the Open edX Community +recommends that you include the peer assessment before the self assessment. .. _Staff Assessment Step: @@ -391,9 +391,9 @@ assessment portions independently. In open response assessments that include only self assessments, the assignment's final score is equivalent to the self assessment score. -.. note:: Given the high level of subjectivity in peer assessments, Open edX - recommends that you make ORA assignments count towards only a small - percentage of a course's final grade. +.. note:: Given the high level of subjectivity in peer assessments, the Open + edX Community recommends that you make ORA assignments count towards only a + small percentage of a course's final grade. The following topics detail how the scores for peer assessments and self assessments are calculated. @@ -539,8 +539,8 @@ assignment. You can allow the **Top Responses** section to show between 1 and 100 responses. Keep in mind, however, that each response might be up to 300 pixels in height in the list. (For longer responses, learners can scroll to see the -entire response.) Open edX recommends that you specify 20 or fewer responses to -prevent the page from becoming too long. +entire response.) The Open edX Community recommends that you specify 20 or +fewer responses to prevent the page from becoming too long. .. note:: It can take up to an hour for a high-scoring response to appear in the **Top Responses** list. @@ -568,8 +568,9 @@ correct or incorrect answers to questions. .. note:: Do not add more than one ORA component in a course unit. Multiple ORA assignments in a unit cause errors when learners submit their assessments. -Open edX suggests that you follow the guidelines and best practices in the -following sections when you use open response assessments in your courses. +The Open edX Community suggests that you follow the guidelines and best +practices in the following sections when you use open response assessments in +your courses. Designing the Assignment ======================== @@ -613,8 +614,9 @@ Peer Assessments ================ * Set the **Must Grade** number higher than the **Graded By** number to - minimize the chance that some responses will not be peer assessed. Open edX - recommends a setting such as **Must Grade** = 4 and **Graded By** = 3. + minimize the chance that some responses will not be peer assessed. The Open + edX Community recommends a setting such as **Must Grade** = 4 and **Graded + By** = 3. * To allow enough time for peer assessments to be performed after learners have submitted their own responses, set the response due date and time at @@ -678,12 +680,11 @@ For more information, see :ref:`PA Allow Images`. Prohibited File Extensions ========================== -Learners cannot upload file types that have the following file name extensions -as part of an open response assessment on openedx.org or Open edX Edge. When -you define a set of custom file types for learners to upload with their -responses, you cannot specify these file types. The extensions on this list are -selected and maintained by the development operations team at Open edX, and are -subject to change. +Learners cannot upload file types with the following file name extensions as +part of and Open Response Assessment. When you define a set of custom file +types for learners to upload with their responses, you cannot specify them. The +extensions on this list are selected and maintained by the development +operations team at the Open edX Community and are subject to 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 From 4daafbefe0c1a5fe96468761e5ca1a414ebd0f0e Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Thu, 9 Jan 2025 11:13:15 -0500 Subject: [PATCH 11/16] docs: update refs of 'using_openedx_as_LTI_provider.rst' file --- .../using_openedx_as_LTI_provider.rst | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) 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 8e60c577c..0439b0ba6 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 @@ -38,21 +38,17 @@ following 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 :ref:`Create a Duplicate Course for LTI use` (how-to) - :ref:`Determine Content Addresses when using Open edX as an LTI Provider` (how-to) + :ref:`Determine Content Addresses` (how-to) :ref:`Planning for Content Reuse (LTI)` (reference) - :ref:`Example: edX as an LTI Provider to Canvas` (reference) + :ref: `Open edX as an LTI Provider to Canvas` (how-to) - :ref:`Example: edX as an LTI Provider to Blackboard` (reference) - - :ref: `edX as an LTI Provider to Canvas` (reference) - - :ref: `edX as an LTI Provider to Blackboard` (reference) + :ref: `Open edX as an LTI Provider to Blackboard` (hot-to) From 1d2621d9e9db966284fd6c0fc9c8f9c04825af21 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Thu, 9 Jan 2025 11:18:52 -0500 Subject: [PATCH 12/16] docs: rewrite paragraph --- .../using_openedx_as_LTI_provider.rst | 27 +++++++++---------- 1 file changed, 13 insertions(+), 14 deletions(-) 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 0439b0ba6..2bebec0aa 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 @@ -16,20 +16,19 @@ Grading Remote Content .. warning:: This feature was a closed pilot experiment. This feature is poorly documented and may not work properly. -When you include the problem components in a graded Open edX subsection in an -external LMS, the Open edX system grades the learner responses to those -problems. The Open edX system then transfers the learner scores back to the -external LMS. This exchange between an external LMS, the Open edX system, and -the external LMS again is near real time. It can take a few moments to complete -this exchange for a single problem component, and up to several minutes to -return aggregated scores of all of the problems in a unit or subsection. - -When you include Open edX problem components in an external LMS, note the -following requirements. - -* The Open edX problem component must be in one of the graded subsections in - your course. - +When you include problem components from a graded subsection in your Open edX +instance in an external LMS, your Open edX instance will grade the learner +responses to those problems. Your instance then transfers the learner scores +back to the external LMS. This exchange between an external LMS, your Open edX +instance, and the external LMS again is near real time. It can take a few +moments to complete this exchange for a single problem component, and up to +several minutes to return aggregated scores of all of the problems in a unit or +subsection. + +When you include problem components from your Open edX instance in an external +LMS, note the following requirements. + +* The problem component must be in one of the graded subsections in your course. * Your external LMS might also require that you use a specific part of the course for graded content. For example, in Canvas, you must add the LTI URL of a problem component to the "Assignments" section of a course, or to a From c87cb858aa0bd7b3d365eaab7732784687bfc8c0 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Thu, 9 Jan 2025 12:28:01 -0500 Subject: [PATCH 13/16] docs: replace 'Open edX Community' --- .../OpenResponseAssessments.rst | 35 ++++++++----------- 1 file changed, 14 insertions(+), 21 deletions(-) diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index 921c9a008..ca504f521 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -209,10 +209,10 @@ assignment to include some combination of the following steps. .. note:: If you include a learner training step, you must also include a peer assessment step. The learner training step must come before peer or self - assessment steps. If you include both peer and self assessment steps, Open - edX recommends that you place the peer assessment before the self - assessment. If you include a staff assessment step, it should be the final - step in the assignment. + assessment steps. If you include both peer and self assessment steps, it is + recommended that you place the peer assessment before the self assessment. + If you include a staff assessment step, it should be the final step in the + assignment. You can see the type and order of the assessments when you look at the assignment. In the following example, after learners submit their responses, they @@ -274,8 +274,8 @@ in the course. For each response, they select an option for each criterion in your rubric based on the response. Learners can also provide text feedback, or comments, on each response. -If you include both peer and self assessment steps, the Open edX Community -recommends that you place the peer assessment before the self assessment. +If you include both peer and self assessment steps, it is recommended that you +place the peer assessment before the self assessment. For information about how peer assessments affect a learner's assignment grade, see :ref:`PA Scoring`. @@ -340,8 +340,8 @@ In self assessment steps, the learner sees her own response followed by the rubr As with peer assessments, the learner evaluates the response using the rubric, selecting an option for each criterion. -If you include both peer and self assessments, the Open edX Community -recommends that you include the peer assessment before the self assessment. +If you include both peer and self assessments, it is recommended that you +include the peer assessment before the self assessment. .. _Staff Assessment Step: @@ -391,8 +391,8 @@ assessment portions independently. In open response assessments that include only self assessments, the assignment's final score is equivalent to the self assessment score. -.. note:: Given the high level of subjectivity in peer assessments, the Open - edX Community recommends that you make ORA assignments count towards only a +.. note:: Given the high level of subjectivity in peer assessments, it is + recommended that you make ORA assignments count towards only a small percentage of a course's final grade. The following topics detail how the scores for peer assessments and self @@ -539,8 +539,8 @@ assignment. You can allow the **Top Responses** section to show between 1 and 100 responses. Keep in mind, however, that each response might be up to 300 pixels in height in the list. (For longer responses, learners can scroll to see the -entire response.) The Open edX Community recommends that you specify 20 or -fewer responses to prevent the page from becoming too long. +entire response.) It is recommended that you specify 20 or fewer responses to +prevent the page from becoming too long. .. note:: It can take up to an hour for a high-scoring response to appear in the **Top Responses** list. @@ -568,9 +568,8 @@ correct or incorrect answers to questions. .. note:: Do not add more than one ORA component in a course unit. Multiple ORA assignments in a unit cause errors when learners submit their assessments. -The Open edX Community suggests that you follow the guidelines and best -practices in the following sections when you use open response assessments in -your courses. +It is suggested that you follow the guidelines and best practices in the +following sections when you use open response assessments in your courses. Designing the Assignment ======================== @@ -680,12 +679,6 @@ For more information, see :ref:`PA Allow Images`. Prohibited File Extensions ========================== -Learners cannot upload file types with the following file name extensions as -part of and Open Response Assessment. When you define a set of custom file -types for learners to upload with their responses, you cannot specify them. The -extensions on this list are selected and maintained by the development -operations team at the Open edX Community and are subject to 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 From 637ea0a2c183970c96b072fb3c6a20172d475bc3 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Thu, 9 Jan 2025 12:35:37 -0500 Subject: [PATCH 14/16] docs: update refs of 'OpenResponseAssessments.rst' file --- .../concepts/exercise_tools/OpenResponseAssessments.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index ca504f521..3e0186ec2 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -17,7 +17,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:`Create Cohort Specific Course Content`. The following topics provide conceptual information about open response assessments. @@ -366,7 +366,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`. From 94b57dc162f3f6cd41e7572a40fd039f8e7c8f74 Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Thu, 9 Jan 2025 12:46:14 -0500 Subject: [PATCH 15/16] chore: replace :doc: by :ref: --- .../concepts/advanced_features/lti_reuse_content.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst index c7a0a4f94..b2d566ce6 100644 --- a/source/educators/concepts/advanced_features/lti_reuse_content.rst +++ b/source/educators/concepts/advanced_features/lti_reuse_content.rst @@ -81,14 +81,14 @@ available in the external LMS. .. seealso:: :class: dropdown - :doc: `using_openedx_as_LTI_provider` (concept) + :ref: `Using Open edX as an LTI Tool Provider` (concept) - :doc: `/how-tos/advanced_features/lti_prepare_content` (how-to) + :ref: `Create a Duplicate Course for LTI use` (how-to) - :doc: `/how-tos/advanced_features/lti_determine_content_address` (how-to) + :ref: `Determine Content Addresses` (how-to) - :doc: `/references/advanced_features/planning_content_reuse` (reference) + :ref: `Planning for Content Reuse` (reference) - :doc: `/references/advanced_features/lti_canvas_example` (reference) + :ref: `Open edX as an LTI Provider to Canvas` (how-to) - :doc: `/references/advanced_features/lti_blackboard_example` (reference) + :ref: `Open edX as an LTI Provider to Blackboard` (how-to) From 72a1b1da6743ab296557c7069f02a23a4d361afa Mon Sep 17 00:00:00 2001 From: Bryann Valderrama Date: Fri, 10 Jan 2025 12:58:53 -0500 Subject: [PATCH 16/16] docs: add deleted paragraph about prohibited file extensions --- .../concepts/exercise_tools/OpenResponseAssessments.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst index 3e0186ec2..3e4fe8e1d 100644 --- a/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst +++ b/source/educators/concepts/exercise_tools/OpenResponseAssessments.rst @@ -679,6 +679,11 @@ For more information, see :ref:`PA Allow Images`. Prohibited File Extensions ========================== +Learners cannot upload file types that have the following file name extensions +as part of an Open Response Assessment in your Open edX courses. When you +define a set of custom file types for learners to upload with their responses, +you cannot specify these file types. + 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