Add information about per-criterion feedback

docs/en_us/ORA2/source/PeerAssessment.rst

@@ -410,13 +410,26 @@ You can use the following code as a template:
 	   </option>
 	 </criterion>
 
-.. _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 ``<feedbackprompt>`` tags between the final ``</criterion>`` tag and the closing ``</rubric>`` tag:
+#. Locate the ``<feedbackprompt>`` tags between the last closing ``</criterion>`` tag for the rubric and the closing ``</rubric>`` tag for the problem:
 
   .. code-block:: xml
 
@@ -437,7 +450,43 @@ To change this text:
       </rubric>
      </openassessment>
 
-#. Change the text between the ``<feedbackprompt>`` tags to the text that you want.
+2. Change the text between the ``<feedbackprompt>`` 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 ``<criterion>`` tag for the criterion that you want to change.
+
+#. Add the ``feedback="optional"`` attribute to this tag:
+
+    .. code-block:: xml
+
+       <criterion feedback="optional">
+         <name>NAME</name>
+         <prompt>PROMPT TEXT</prompt>
+         <option points="NUMBER">
+           <name>NAME</name>
+           <explanation>EXPLANATION</explanation>
+         </option>
+         <option points="NUMBER">
+           <name>NAME</name>
+           <explanation>EXPLANATION</explanation>
+         </option>
+       </criterion>
+
+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:
 

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 #<number>**.
 
+.. 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.