diff --git a/source/educators/concepts/advanced_features/lti_reuse_content.rst b/source/educators/concepts/advanced_features/lti_reuse_content.rst index 0fd709da..c7a0a4f9 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 d0d7e7ad..3ef0636f 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 f4e0987a..a9ba95bd 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 62629645..8e60c577 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 c7ba22d0..921c9a00 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