diff --git a/docs/en_us/ORA2/source/Images/PA_CommentsField.png b/docs/en_us/ORA2/source/Images/PA_CommentsField.png new file mode 100644 index 0000000000..63426f0948 Binary files /dev/null and b/docs/en_us/ORA2/source/Images/PA_CommentsField.png differ diff --git a/docs/en_us/ORA2/source/Images/PA_Comments_Criterion.png b/docs/en_us/ORA2/source/Images/PA_Comments_Criterion.png new file mode 100644 index 0000000000..fe66b083dd Binary files /dev/null and b/docs/en_us/ORA2/source/Images/PA_Comments_Criterion.png differ diff --git a/docs/en_us/ORA2/source/Images/PA_CourseStaffInfo_Collapsed.png b/docs/en_us/ORA2/source/Images/PA_CourseStaffInfo_Collapsed.png new file mode 100644 index 0000000000..9a66e4ce0b Binary files /dev/null and b/docs/en_us/ORA2/source/Images/PA_CourseStaffInfo_Collapsed.png differ diff --git a/docs/en_us/ORA2/source/Images/PA_Students_CommentBoxes.png b/docs/en_us/ORA2/source/Images/PA_Students_CommentBoxes.png new file mode 100644 index 0000000000..aef2f9618f Binary files /dev/null and b/docs/en_us/ORA2/source/Images/PA_Students_CommentBoxes.png differ diff --git a/docs/en_us/ORA2/source/PeerAssessment.rst b/docs/en_us/ORA2/source/PeerAssessment.rst index c7c88d681a..719991098f 100644 --- a/docs/en_us/ORA2/source/PeerAssessment.rst +++ b/docs/en_us/ORA2/source/PeerAssessment.rst @@ -410,13 +410,26 @@ You can use the following code as a template: -.. _PA Change Feedback Prompt: +.. _PA Provide Comment Options: ============================================= -Step 6 (optional). Change the Feedback Prompt +Step 6 (optional). Provide Comment Options ============================================= -After students have filled out the rubric, they can provide additional feedback for the responses they've assessed. By default, the prompt text for this feedback is the following: +After students fill out the rubric, they can provide additional comments for the responses they've assessed. By default, students see a field for comments below the rubric. + +.. image:: /Images/PA_CommentsField.png + :alt: Contents field + :width: 500 + +You can change the text that appears above this comment field. Additionally, you can provide a comment field for each individual criterion. + +.. _PA Change Comments Prompt: + +Change the Default Prompt Text +******************************* + +By default, the prompt text for the comment field is the following: ``(Optional) What aspects of this response stood out to you? What did it do well? How could it improve?`` @@ -424,7 +437,7 @@ You can replace this default text with your own text. To change this text: -#. Locate the ```` tags between the final ```` tag and the closing ```` tag: +#. Locate the ```` tags between the last closing ```` tag for the rubric and the closing ```` tag for the problem: .. code-block:: xml @@ -437,7 +450,43 @@ To change this text: -#. Change the text between the ```` tags to the text that you want. +2. Change the text between the ```` tags to the text that you want. + +.. _PA Add Individual Criterion Comments: + +Provide a Comment Field for Individual Criteria +************************************************** + +By default, students see only a single comment field below the entire rubric. However, you can add a comment field to an individual criterion or to several individual criteria. The comment field can contain up to 300 characters. + +In the following image, the first criterion has a comment field, but the second does not. + +.. image:: /Images/PA_Comments_Criterion.png + :alt: Comment box under an individual criterion + :width: 500 + +To add a comment field: + +#. Locate the opening ```` tag for the criterion that you want to change. + +#. Add the ``feedback="optional"`` attribute to this tag: + + .. code-block:: xml + + + NAME + PROMPT TEXT + + + + +If you want to provide comment fields below additional criteria, add the ``feedback="optional"`` attribute to the opening tag for each criterion that you want. .. _PA Test Problem: diff --git a/docs/en_us/ORA2/source/PeerAssessment_Students.rst b/docs/en_us/ORA2/source/PeerAssessment_Students.rst index cca4ab9be2..b6eab4c564 100644 --- a/docs/en_us/ORA2/source/PeerAssessment_Students.rst +++ b/docs/en_us/ORA2/source/PeerAssessment_Students.rst @@ -67,6 +67,12 @@ The rubric contains *criteria*, each of which has several *options*. Read the st When you've selected options in the rubric, provide additional comments about the response in the field below the rubric. When you're done, click **Submit your assessment and move to response #**. +.. note:: Some assessments may have an additional **Comments** field for one or more of the assessment's individual criteria. You can enter up to 300 characters in these fields. In the following image, the first of the criteria has a separate **Comments** field, but the second does not. + + .. image:: /Images/PA_Students_CommentBoxes.png + :alt: Rubric with call-outs for comment boxes + :width: 500 + When you submit your assessment of the first student's response, another response opens for you. Assess this response in the same way that you assessed the first response, and then submit your assessment. You'll repeat these steps until you've assessed the required number of responses. The number in the upper-right corner of the rubric updates as you assess each response.