From 6f2d3018dc433ab8ffa8052917f895549503ad68 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Sat, 28 Dec 2024 22:15:58 -0500 Subject: [PATCH 1/3] FC-0068 docs: How-to cleaning by edunext #8 This PR modifies a series of how-to documents migrated from the legacy repositories to the educators' documentation. --- .../add_content_experiments_olx.rst | 10 +- .../test_content_experiments.rst | 24 ++- .../add_components_library.rst | 55 ++++++ .../course_development/create_library.rst | 164 ++---------------- .../course_development/delete_library.rst | 40 +++++ .../edit_components_library.rst | 43 +++++ .../course_development/edit_library.rst | 56 ++++++ .../exercise_tools/CreateORAAssignment.rst | 110 ++++++------ .../view_content_legacy_library.rst | 61 +++++++ .../content_creation_management.rst | 5 + 10 files changed, 345 insertions(+), 223 deletions(-) create mode 100644 source/educators/how-tos/course_development/add_components_library.rst create mode 100644 source/educators/how-tos/course_development/delete_library.rst create mode 100644 source/educators/how-tos/course_development/edit_components_library.rst create mode 100644 source/educators/how-tos/course_development/edit_library.rst create mode 100644 source/educators/how-tos/course_development/view_content_legacy_library.rst diff --git a/source/educators/how-tos/advanced_features/add_content_experiments_olx.rst b/source/educators/how-tos/advanced_features/add_content_experiments_olx.rst index 5dad64ed2..823420908 100644 --- a/source/educators/how-tos/advanced_features/add_content_experiments_olx.rst +++ b/source/educators/how-tos/advanced_features/add_content_experiments_olx.rst @@ -2,9 +2,8 @@ .. _Add a Content Experiment in OLX: -**************************************** Add a Content Experiment in OLX -**************************************** +################################ .. tags:: educator, how-to @@ -12,9 +11,8 @@ You work with multiple XML files to configure a content experiment. This section steps through the files involved in a content experiment that shows different content to two different groups of learners. -===================================================== Define the Content Experiment in the Sequential File -===================================================== +***************************************************** You reference a content experiment in the file for the subsection, or sequential, in the ``sequential`` directory. For example: @@ -33,9 +31,9 @@ content experiment file in the ``split_test`` directory. .. caution:: You can only define a content experiment in a unit, or vertical, in which different collections of components are associated with different experiment groups. You cannot define a content experiment at a subsection (sequential) or section (chapter) level and have different units or subsections associated with different groups. -===================================================== + Define the Experiment Content in the Split Test File -===================================================== +****************************************************** After you define the content experiment in the sequential file, you define the course content you want to test in the file in the ``split_test`` directory. diff --git a/source/educators/how-tos/advanced_features/test_content_experiments.rst b/source/educators/how-tos/advanced_features/test_content_experiments.rst index 00f20292d..2eb233c79 100644 --- a/source/educators/how-tos/advanced_features/test_content_experiments.rst +++ b/source/educators/how-tos/advanced_features/test_content_experiments.rst @@ -2,9 +2,10 @@ .. experiments. We did not use an include because file structure differs in .. the OLX guide and shared relative paths did not work. CT Nov 2015 -########################################## +.. _Test Content Experiments: + Test Content Experiments -########################################## +########################### .. tags:: educator, how-to @@ -34,4 +35,21 @@ different experiment group of learners sees. .. note:: The example course content in this section uses content experiment terminology ("Welcome to Group A", for example) to make the functionality clear. Typically, you would not use terminology in course content that would - make learners aware of the experiment. \ No newline at end of file + make learners aware of the experiment. + +.. seealso:: + :class: dropdown + + :ref:`Offering Differentiated Content` (concept) + + :ref:`Overview of Content Experiments` (concept) + + :ref:`Configure Your Course for Content Experiments` (how-to) + + :ref:`Add a Content Experiment in OLX` (how-to) + + :ref:`Create Content for Content Experiment Groups` (how-to) + + :ref:`Create a Content Experiment` (how-to) + + :ref:`Add Content Experiments to Your Course` (reference) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/add_components_library.rst b/source/educators/how-tos/course_development/add_components_library.rst new file mode 100644 index 000000000..0b59f4e55 --- /dev/null +++ b/source/educators/how-tos/course_development/add_components_library.rst @@ -0,0 +1,55 @@ +.. _Add Components to a Library: + +Add Components to a Legacy Library +################################## + +.. tags:: educator, how-to + +To add new :ref:`components` to your library, +follow these steps. + +#. Log in to Studio. + +#. Select **Libraries**, then select the library that you want to add + components to. + +#. Select **Add Component**, then select the component type that you want to + add under **Add New Component**. + +For more information about the types of components you can add to a library, +see these topics. + +* :ref:`Working with Text Components` +* :ref:`Working with Problem Components` +* :ref:`Working with Video Components` + +After you add a component to a library, you can edit its settings. These +settings are retained when the component is selected from the library and used +in a course. + +When a component from the library is used in a randomized content block, you +can further edit the component as it exists in the unit, without affecting the +original version in the library. For details, refer to :ref:`Edit Components in +a Library` and :ref:`Get the Latest Version of Library Content `. + + +.. seealso:: + :class: dropdown + + :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` + + :ref:`Content Libraries Overview` (concept) + + :ref:`Create a New Library` (how-to) + + :ref:`Edit a Library` (how-to) + + :ref:`View the Contents of a Library` (how-to) + + :ref:`Edit Components in a Library` (how-to) + + :ref:`Delete a Library` (how-to) + + :ref:`Give Other Users Access to Your Library` (how to) + + :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/how-tos/course_development/create_library.rst b/source/educators/how-tos/course_development/create_library.rst index 5781af525..83369f738 100644 --- a/source/educators/how-tos/course_development/create_library.rst +++ b/source/educators/how-tos/course_development/create_library.rst @@ -6,7 +6,7 @@ Create a New Legacy Library .. tags:: educator, how-to -Use :ref:`legacy content libraries` to build a pool of components +Use :ref:`legacy content libraries` to build a pool of components that can be used in randomized assignments in your courses. .. warning:: @@ -59,158 +59,6 @@ for the library. For information about adding other users to a library after you create it, see :ref:`Give Other Users Access to Your Library`. -.. _Edit a Library: - -********************* -Edit a Legacy Library -********************* - -After you create a library, the only change you can make to the initial library -information is to the name. However, at any time, you can make changes to the -components in your library, including adding or deleting components or editing -the settings of components. For details about editing the contents of a -library, see :ref:`Edit Components in a Library` and :ref:`Add Components to a -Library`. - -To change the name of a library, follow these steps. - -#. Log in to Studio. - -#. Select **Libraries**, then select the library whose name you want to edit. - -#. Select the **Edit** icon next to the library name. - - The library name field becomes editable. - - .. image:: /_images/educator_how_tos/ContentLibrary_EditName.png - :alt: The Edit icon to the right of the Library Name. - :width: 300 - -#. In the library name field, make edits or enter a new library name. - -#. Select anywhere outside the library name field to save your changes. - -For details about giving other users access to the library, see :ref:`Give -Other Users Access to Your Library`. - -.. _Add Components to a Library: - -********************************** -Add Components to a Legacy Library -********************************** - -To add new :ref:`components` to your library, -follow these steps. - -#. Log in to Studio. - -#. Select **Libraries**, then select the library that you want to add - components to. - -#. Select **Add Component**, then select the component type that you want to - add under **Add New Component**. - -For more information about the types of components you can add to a library, -see these topics. - -* :ref:`Working with Text Components` -* :ref:`Working with Problem Components` -* :ref:`Working with Video Components` - -After you add a component to a library, you can edit its settings. These -settings are retained when the component is selected from the library and used -in a course. - -When a component from the library is used in a randomized content block, you -can further edit the component as it exists in the unit, without affecting the -original version in the library. For details, refer to :ref:`Edit Components in -a Library` and :ref:`Get the Latest Version of Library Content `. - -.. _View the Contents of a Library: - -************************************* -View the Contents of a Legacy Library -************************************* - -To view the entire contents of a library in Studio, follow these steps. - -#. Log in to Studio. - -#. Select **Libraries**, then select the library whose components you want to - view. - -#. Optionally, select **Hide Previews** at the top right of the library page to - collapse the component previews and see only the list of component display - names. To return to the full preview of components in the library, select - **Show Previews**. - -The components in the library are shown in the order in which they were added, -with the most recently added at the bottom. If your library has more than 10 -components, additional components are shown on other pages. - -The range of the components shown on the current page, and the total number of -components, are shown at the top of the page. - -You can navigate through the pages in the following ways. - -* Use the **<** and **>** buttons at the top and bottom of the list to navigate - to the previous and next pages. - -* At the bottom of the page, you can edit the first number in the page range. - Select the number to place your cursor in the field, then enter the page - number you want to jump to. - - .. image:: /_images/educator_how_tos/file_pagination.png - :alt: Image showing a pair of page numbers with the first number circled. - :width: 300 - -To view the list of matching components in the library, see :ref:`View the -Matching Components in a Randomized Content Block`. - -To view the randomized content that was assigned to a specific learner, see -:ref:`Specific Student View`. - - -.. _Edit Components in a Library: - -*********************************** -Edit Components in a Legacy Library -*********************************** - -After you have added components to a library, you can edit, duplicate, or -delete them. - -For step-by-step instructions for editing, duplicating, or deleting components, -refer to the following topics. - -* :ref:`Edit a Component` -* :ref:`Duplicate a Component` -* :ref:`Delete a Component` - -.. note:: If you modify components in your library that are in use in a course, - these updates in the "source" library are not reflected in the course unless - you manually update the randomized content block in the course unit. For - details about updating library components used in your course to match the - latest version in the library, see :ref:`Get the Latest Version of Library - Content`. - -.. _Delete a Library: - -*********************** -Delete a Legacy Library -*********************** - -You cannot delete a library. Instead, you can discontinue use of an unwanted -library. To do so, first make sure that none of its components are in use in -any courses, then delete all components in the library. You can also :ref:`edit -the name of the library` to make it clear to other course team -members that the library should not be used as a source of randomized -assignment content in courses. - -For details about deleting components in a library, see :ref:`Edit Components -in a Library`. - - .. seealso:: :class: dropdown @@ -218,6 +66,16 @@ in a Library`. :ref:`Content Libraries Overview` (concept) + :ref:`Edit a Library` (how-to) + + :ref:`Add Components to a Library` (how-to) + + :ref:`View the Contents of a Library` (how-to) + + :ref:`Edit Components in a Library` (how-to) + + :ref:`Delete a Library` (how-to) + :ref:`Give Other Users Access to Your Library` (how to) :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/how-tos/course_development/delete_library.rst b/source/educators/how-tos/course_development/delete_library.rst new file mode 100644 index 000000000..dad3ad12c --- /dev/null +++ b/source/educators/how-tos/course_development/delete_library.rst @@ -0,0 +1,40 @@ +.. _Delete a Library: + +Delete a Legacy Library +######################## + +.. tags:: educator, how-to + +You cannot delete a library. Instead, you can discontinue use of an unwanted +library. To do so, follow the next steps: + +#. First, make sure that none of its components are in use in +any courses. + +#. Delete all components in the library. + +#. :ref:`Edit the name of the library` to make it clear to other course team +members that the library should not be used as a source of randomized +assignment content in courses. + + +.. seealso:: + :class: dropdown + + :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` + + :ref:`Content Libraries Overview` (concept) + + :ref:`Create a New Library` (how-to) + + :ref:`Edit a Library` (how-to) + + :ref:`Add Components to a Library` (how-to) + + :ref:`View the Contents of a Library` (how-to) + + :ref:`Edit Components in a Library` (how-to) + + :ref:`Give Other Users Access to Your Library` (how to) + + :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/how-tos/course_development/edit_components_library.rst b/source/educators/how-tos/course_development/edit_components_library.rst new file mode 100644 index 000000000..9202a8b32 --- /dev/null +++ b/source/educators/how-tos/course_development/edit_components_library.rst @@ -0,0 +1,43 @@ +.. _Edit Components in a Library: + +Edit Components in a Legacy Library +#################################### + +.. tags:: educator, how-to + +After you have :ref:`Add Components to a Library`, you can edit, duplicate, or +delete them. + +For step-by-step instructions for editing, duplicating, or deleting components, +refer to the following topics. + +* :ref:`Edit a Component` +* :ref:`Duplicate a Component` +* :ref:`Delete a Component` + +.. note:: If you modify components in your library that are in use in a course, + these updates in the "source" library are not reflected in the course unless + you manually update the randomized content block in the course unit. For + details about updating library components used in your course to match the + latest version in the library, see :ref:`Get the Latest Version of Library + Content`. + + +.. seealso:: + :class: dropdown + + :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` + + :ref:`Content Libraries Overview` (concept) + + :ref:`Create a New Library` (how-to) + + :ref:`Edit a Library` (how-to) + + :ref:`Add Components to a Library` (how-to) + + :ref:`View the Contents of a Library` (how-to) + + :ref:`Give Other Users Access to Your Library` (how to) + + :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/how-tos/course_development/edit_library.rst b/source/educators/how-tos/course_development/edit_library.rst new file mode 100644 index 000000000..022aff7f2 --- /dev/null +++ b/source/educators/how-tos/course_development/edit_library.rst @@ -0,0 +1,56 @@ +.. _Edit a Library: + +Edit a Legacy Library +##################### + +.. tags:: educator, how-to + +After you create a library, the only change you can make to the initial library +information is to the name. However, at any time, you can make changes to the +components in your library, including adding or deleting components or editing +the settings of components. For details about editing the contents of a +library, see :ref:`Edit Components in a Library` and :ref:`Add Components to a +Library`. + +To change the name of a library, follow these steps. + +#. Log in to Studio. + +#. Select **Libraries**, then select the library whose name you want to edit. + +#. Select the **Edit** icon next to the library name. + + The library name field becomes editable. + + .. image:: /_images/educator_how_tos/ContentLibrary_EditName.png + :alt: The Edit icon to the right of the Library Name. + :width: 300 + +#. In the library name field, make edits or enter a new library name. + +#. Select anywhere outside the library name field to save your changes. + +For details about giving other users access to the library, see :ref:`Give +Other Users Access to Your Library`. + + +.. seealso:: + :class: dropdown + + :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` + + :ref:`Content Libraries Overview` (concept) + + :ref:`Create a New Library` (how-to) + + :ref:`Add Components to a Library` (how-to) + + :ref:`View the Contents of a Library` (how-to) + + :ref:`Edit Components in a Library` (how-to) + + :ref:`Delete a Library` (how-to) + + :ref:`Give Other Users Access to Your Library` (how to) + + :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst b/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst index 3ff8c380c..6235c617d 100644 --- a/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst +++ b/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst @@ -6,17 +6,16 @@ Create an Open Response Assessment Assignment .. tags:: educator, how-to -Creating an :ref:`open response assessment (ORA) assignment ` is a multi-step process. This section covers each step in +Creating an :ref:`open response assessment (ORA) assignment ` is a multi-step process. This section covers each step in detail. .. contents:: :local: :depth: 1 -In addition, see these other topics about different aspects of open response -assessments. +In addition, you can also review other topics about different aspects of Open Response Assessments. -* Components of an open response assessment: :ref:`Open Response Assessments Two` +* Components of an :ref:`Open Response Assessments` * Viewing metrics and learner responses for released open response assessments: :ref:`Accessing ORA Assignment Information` @@ -34,9 +33,9 @@ of creating and configuring Team ORAs is similar to that for individual ORAs, bu deviations and notes for Teams are included in the instructions below. Before setting up a Team Open Response Assessment, make sure that you have set up -your course's Team Configuration to define the desired team-sets in the +your course's Team Configuration to define the desired team sets in the **Settings > Advanced Configuration** menu. See :ref:`Enable and Configure Teams ` -for help setting up team-sets. +for help setting up team sets. .. _PA Create Component: @@ -56,11 +55,11 @@ steps. #. Under **Add New Component**, select **Open Response**. -#. Select one of the the Open Response Assessment templates listed. +#. Select one of the Open Response Assessment templates listed. #. In the problem component that appears, select **Edit**. - You use this component editor to add prompts and the rubric, and to specify + You use this component editor to add prompts and the rubric and to specify other settings for the open response assessment component. #. Select **Save** each time you complete an editing session. You can continue @@ -70,8 +69,7 @@ steps. structure of the rubric or the point values associated with each criterion in the rubric. If you correct typographical errors in the text of the rubric, only learners who have not yet started the assignment will see the - corrections. However, you can modify due dates and the weight of the ORA - assignment after you publish an ORA assignment. + corrections. However, you can modify the due dates and the weight of the ORA assignment after you have published it. .. _PA Add Prompt: @@ -84,12 +82,12 @@ You can format text and add images inside an open response assessment prompt the same way you would for a Text component. For more information, see :ref:`The Visual Editor`. -To add :ref:`prompts`, or questions, to your ORA assignment, +To add :ref:`prompts` or questions to your ORA assignment, complete these steps. -#. In the open response assessment component editor, select **Prompt**. +#. In the open response assessment component editor, select a **Prompt**. #. Replace the example prompt with your prompt. -#. To add another prompt in the assignment, select **Add a Prompt**, and then +#. To add another prompt to the assignment, select **Add a Prompt**, and then repeat step 2. @@ -113,7 +111,7 @@ problem, regardless of the number of prompts in the problem. For each step below, replace any default text with your own text. -.. note:: All open response assessments include a feedback field below the +.. note:: All the Open Response Assessments include a feedback field below the rubric so that learners can provide written feedback on a peer's overall response. You can also allow or require learners to provide feedback for individual criteria. See step 4 in the following procedure for instructions. @@ -124,10 +122,10 @@ To add the rubric, follow these steps. #. In the ORA component editor, select the **Rubric** tab. #. In the first **Criterion** section, enter the name and prompt text of your - first criterion (100 character limit). + first criterion (100-character limit). #. In the **Option** sections for this criterion, for each option that you - provide for the criterion enter a name, explanation, and point value. + provide for the criterion, enter a name, explanation, and point value. To remove options, select **Remove** at the top right of the option section. @@ -139,23 +137,22 @@ To add the rubric, follow these steps. * If you do not want to allow feedback for this individual criterion, select **None**. * To require feedback for this criterion, select **Required**. - * To allow feedback, but not require it, select **Optional**. + * To allow feedback but not require it, select **Optional**. #. Repeat steps 2-4 to create additional criteria. To add more criteria than - provided for in the template, select **Add Criterion** at the end of the + provided in the template, select **Add Criterion** at the end of the list of criteria. #. Under **Feedback for This Response**, add instructions for learners to provide overall written feedback on responses that they assess. You can leave the default text in the **Feedback Instructions** and **Default - Feedback Text** fields, or replace it with your own text. + Feedback Text** fields or replace it with your own text. .. note:: After you publish an ORA assignment, you can no longer change the structure of the rubric or the point values associated with each criterion in the rubric. If you correct typographical errors in the text of the rubric, only learners who have not yet started the assignment will see the - corrections. However, you can modify due dates and the weight of the ORA - assignment after you publish an ORA assignment. + corrections. However, you can modify the ORA assignments' due dates and weight after publishing them. .. note:: If you wish to allow learners to view the rubric as they work on their response, see :ref:`Show Rubric During Response` @@ -173,8 +170,7 @@ To provide a comment field without options, complete these steps. #. In the ORA component editor, select the **Rubric** tab. -#. In the **Criterion** section for the criterion that you want to only - provide a comment field for, select **Remove** to remove each option. +#. In the **Criterion** section, for the criterion you only want to provide a comment field, select **Remove** to remove each option. #. Next to **Feedback for This Criterion**, select **Required** from the list. @@ -192,24 +188,21 @@ To reuse a rubric, complete the following steps: #. In the ORA component editor, select the **Rubric** tab. -#. Expand the **Clone Rubric** section (if it is not already expanded) and copy or note - the value following "Block ID for this ORA". This will allow you to uniquely - identify this ORA later. +#. Expand the **Clone Rubric** section (if it has not already been expanded) and copy or note the value following "Block ID for this ORA". This will allow you to identify this ORA uniquely later. #. Navigate to (or create) an unpublished ORA where you'd like to reuse the rubric. #. In the ORA component editor, select the **Rubric** tab and expand the **Clone Rubric** section. -#. In the "Block ID" dropdown, paste or select the ID of the ORA to copy rubric data - from. +#. In the **Block ID** dropdown, paste or select the ID of the ORA from which to copy rubric data. -#. Click "Clone". A banner should appear saying "Rubric Successfully Cloned from +#. Click **Clone**. A banner should appear saying, "Rubric Successfully Cloned from Block ID: ". .. note:: Cloning rubric data clears Learner Training examples. If applicable, - follow the instructions at :ref:`learner training step` to + follow the instructions at the :ref:`learner training step` to add updated Learner Training examples. .. note:: @@ -225,8 +218,7 @@ Step 4. Specify Additional Settings After you have added a prompt and rubric, you must specify additional settings for the assignment. These settings include the type of response that learners -must submit, assignment dates, and whether learners will see a list of top -scoring responses. +must submit, assignment dates, and whether learners will see a list of top-scoring responses. .. _PA Team vs Individual ORA: @@ -234,20 +226,20 @@ scoring responses. Team vs. Individual ORA ======================== -To make a Team ORA, set the option **Teams Enabled** to **True**\. -This reveals a drop down for **Selected Team-set** that defines which +To make a Team ORA, set the option **Teams Enabled** to **True**. +This reveals a dropdown for the **Selected Team set** that defines which group of teams will be able to submit a response for this assignment. .. image:: /_images/educator_how_tos/ORA_CreateTeamORA.png :alt: The settings page with the control which toggles individual / team ORA. :width: 500 -Students can be in one team per team-set, so configuring multiple team-sets +Students can be in one team per team set, so configuring multiple team sets allows you to create groups for different assignments. You could, for example, create separate team-sets for Homework, Midterms, and the Final Project, each selected for the relevant Team ORAs to allow students to collaborate with different classmates for each assignment type. For more on how to configure -team-sets for your course, see :ref:`Enable and Configure Teams `\. +team sets for your course, see :ref:`Enable and Configure Teams `\. For Team ORAs, File Upload is the main intended form of response. Learners on a team can collaboratively upload and review files as part of a team response. @@ -263,7 +255,7 @@ Specify the Response Type ========================= Learners can submit written responses, files, or both in their responses to the -assigment. If you want learners to upload files, make sure the text of your +assignent. If you want learners to upload files, make sure the text of your prompt includes adequate instructions for learners to upload the required files, including the file types that learners can upload. @@ -298,7 +290,7 @@ these steps. * **Required** * **Optional** - If you select **Required** or **Optional**, **Allow Multiple Files** and **File Upload Types** will + If you select **Required** or **Optional**, **Allow Multiple Files**, and **File Upload Types** will appear. For **Allow Multiple Files**, select either **True** or **False**. If **Allow Multiple Files** is @@ -323,13 +315,13 @@ these steps. .. _PA Show Rubric During Response: -============================================== -Allow Learners to View Rubric While Responding -============================================== +=================================================== +Allow Learners to View the Rubric While Responding +=================================================== -By default, learners cannot see the rubric while they are working on their response. +By default, learners cannot see the rubric while they are working on their responses. However, you may decide that it would be helpful for learners to be able to view the -rubric while they work on their response so they know how they will be evaluated. To +rubric while they work on their responses so they know how they will be evaluated. To enable this functionality: #. In the ORA component editor, select **Settings**. @@ -349,14 +341,11 @@ will be graded. Include Top Responses ===================== -You can specify whether learners see a section that shows the :ref:`highest -scoring responses` that were submitted for each question in -the assignment. If offered, this section displays only after each learner has -completed all steps in the assignment. You specify the number of highest -scoring responses to show. +You can specify whether learners see a section that shows the :ref:`highest-scoring responses` that were submitted for each question in +the assignment. If offered, this section will be displayed after each learner has completed all assignment steps. You specify the number of highest-scoring responses to show. .. note:: Because each response can be up to 300 pixels in height, we - recommend that you set the number of top responses lower than 20, to + recommend that you set the number of top responses lower than 20 to prevent the page from becoming too long. #. In the ORA component editor, select **Settings**. @@ -380,14 +369,14 @@ assessment, self assessment, and staff assessment steps. When adding an ORA problem, the component editor provides some predefined ORA problem templates with different :ref:`steps` set up in a sequence that works well for most courses. While you can change the -order of the peer, self, and staff assessment steps, edX recommends that +order of the peer, self, and staff assessment steps, it is recommended that you include them in this order. .. 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 + 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 @@ -411,7 +400,7 @@ To add steps to the open response assignment, complete these actions. include. #. (optional) To change the order of the steps, drag the steps into the order - that you want using the bar at the left side of the steps. + that you want using the bar on the left side of the steps. .. _PA ORA Assignment Schedule: @@ -437,12 +426,12 @@ With this option, you have the ability to set individual deadlines for each step the Open Response Assessment individually. The options that you can set include: * **Response Start Date** and **Response Start Time**: These settings define when - learners can begin working on their response. Before this date and time, learners + learners can begin working on their responses. Before this date and time, learners cannot type a response or upload files. After, they can begin to work on their response and upload files. * **Response Due Date** and **Response Due Time**: These settings define the date / time by which - learners must complete and submit their response. After this date / time passes, learners + learners must complete and submit their responses. After this date / time passes, learners can no longer submit responses to the problem. * **Peer Assessment Start Date** and **Peer Assessment Start Time**: These settings define @@ -450,11 +439,10 @@ the Open Response Assessment individually. The options that you can set include: that peer assessment has not yet begun. * **Peer Assessment Due Date** and **Peer Assessment Due Time**: These settings define the date / time - by which learners must complete assessing peer responses. After this date / time has passed learners will - no longer be able to assess peers. If learners have not assessed the required number of peers before this - deadline, they will not be able to recieve a grade. + by which learners must complete assessing peer responses. After this date / time has passed, learners will no longer be able to assess their peers. If learners have not assessed the required number of peers before this + deadline, they will not be able to receive a grade. -* **Self Assessment Start Date** and **Self Assessment Start TIme**: These settings define +* **Self Assessment Start Date** and **Self Assessment Start Time**: These settings define when learners can begin to self-assess their responses. Before this time, learners will receive a message that self assessment has not yet begun. @@ -474,7 +462,7 @@ the Open Response Assessment individually. The options that you can set include: .. note:: You should allow sufficient time for peer assessments to be performed after - learners have submitted their own responses. EdX recommends that you allow at + learners have submitted their own responses. It is recommended that you allow at least one week between the due date for responses and the due date for peer assessments. If the response due time and peer assessment due time are close together, and a learner submits a response just before responses are due, @@ -531,7 +519,7 @@ steps. .. note:: If you make changes to a step, and then clear the check box for that step, - the step will no longer be part of the assignment and your changes will not + the step will no longer be part of the assignment, and your changes will not be saved. For Team ORAs, Staff assessments are the only assessment step allowed, @@ -606,7 +594,7 @@ the step starts and ends. learners can begin assessing their peers' responses. #. Next to **Due Date** and **Due Time**, enter the date and time by which all - peer assessments must be complete. + peer assessments must be completed. .. note:: diff --git a/source/educators/how-tos/course_development/view_content_legacy_library.rst b/source/educators/how-tos/course_development/view_content_legacy_library.rst new file mode 100644 index 000000000..d09e32b8a --- /dev/null +++ b/source/educators/how-tos/course_development/view_content_legacy_library.rst @@ -0,0 +1,61 @@ +.. _View the Contents of a Library: + +View the Contents of a Legacy Library +###################################### + +.. tags:: educator, how-to + +To view the entire contents of a library in Studio, follow these steps. + +#. Log in to Studio. + +#. Select **Libraries**, then select the library whose components you want to + view. + +#. Optionally, select **Hide Previews** at the top right of the library page to + collapse the component previews and see only the list of component display + names. To return to the full preview of components in the library, select + **Show Previews**. + +The components in the library are shown in the order in which they were added, +with the most recently added at the bottom. If your library has more than 10 +components, additional components are shown on other pages. + +The range of the components shown on the current page, and the total number of +components, are shown at the top of the page. + +You can navigate through the pages in the following ways. + +* Use the **<** and **>** buttons at the top and bottom of the list to navigate + to the previous and next pages. + +* At the bottom of the page, you can edit the first number in the page range. + Select the number to place your cursor in the field, then enter the page + number you want to jump to. + + .. image:: /_images/educator_how_tos/file_pagination.png + :alt: Image showing a pair of page numbers with the first number circled. + :width: 300 + +To view the list of matching components in the library, see :ref:`View the +Matching Components in a Randomized Content Block`. + +To view the randomized content that was assigned to a specific learner, see +:ref:`Specific Student View`. + +.. seealso:: + :class: dropdown + + :doc:`/community/release_notes/sumac/content_libraries_redesign_beta` + + :ref:`Content Libraries Overview` (concept) + + :ref:`Create a New Library` (how-to) + + :ref:`Edit a Library` (how-to) + + :ref:`Add Components to a Library` (how-to) + + :ref:`Give Other Users Access to Your Library` (how to) + + :ref:`Exporting and Importing a Library` (how to) diff --git a/source/educators/navigation/content_creation_management.rst b/source/educators/navigation/content_creation_management.rst index 64e96aa20..11b81fda0 100644 --- a/source/educators/navigation/content_creation_management.rst +++ b/source/educators/navigation/content_creation_management.rst @@ -238,6 +238,11 @@ make it easy to convert a Legacy Library into the new Library interface. ../concepts/instructional_design/libraries.rst ../how-tos/course_development/create_library.rst + ../how-tos/course_development/edit_library.rst + ../how-tos/course_development/add_components_library.rst + ../how-tos/course_development/view_content_legacy_library.rst + ../how-tos/course_development/edit_components_library.rst + ../how-tos/course_development/delete_library.rst ../how-tos/course_development/library_access.rst ../how-tos/course_development/export_import_library.rst ../how-tos/leveraging_libraries.rst \ No newline at end of file From cf79eb7585b57716f5f56d70697183fada74e9d5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Sat, 28 Dec 2024 22:28:37 -0500 Subject: [PATCH 2/3] Update create_library.rst --- source/educators/how-tos/course_development/create_library.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/how-tos/course_development/create_library.rst b/source/educators/how-tos/course_development/create_library.rst index 83369f738..51c97462e 100644 --- a/source/educators/how-tos/course_development/create_library.rst +++ b/source/educators/how-tos/course_development/create_library.rst @@ -6,7 +6,7 @@ Create a New Legacy Library .. tags:: educator, how-to -Use :ref:`legacy content libraries` to build a pool of components +Use :ref:`legacy content libraries` to build a pool of components that can be used in randomized assignments in your courses. .. warning:: From ecde5a0dcbc171298b08e5a1682fd214760a08b3 Mon Sep 17 00:00:00 2001 From: Sarina Canelake Date: Mon, 6 Jan 2025 08:25:58 -0500 Subject: [PATCH 3/3] Update source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst --- .../course_development/exercise_tools/CreateORAAssignment.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst b/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst index 6235c617d..35bd0b8c1 100644 --- a/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst +++ b/source/educators/how-tos/course_development/exercise_tools/CreateORAAssignment.rst @@ -255,7 +255,7 @@ Specify the Response Type ========================= Learners can submit written responses, files, or both in their responses to the -assignent. If you want learners to upload files, make sure the text of your +assignment. If you want learners to upload files, make sure the text of your prompt includes adequate instructions for learners to upload the required files, including the file types that learners can upload.