Merge pull request #573 from edx/sylvia/docs/ORA-65

Sylvia/docs/ora 65

docs/en_us/course_authors/source/PeerAssessment_Students.rst

@@ -22,6 +22,8 @@ A *rubric* is a list of expectations that a response should meet. Rubrics are ma
 
 When you assess a response, you'll select the option that best describes the response for each of the criteria. 
 
+Some instructors create a **Top Responses** section that shows the top-scoring responses for the assignment and the scores that these responses received. If an instructor creates this section, you can see it below your score after you've completed each step of the assignment. 
+
 ************************
 Student Instructions
 ************************
@@ -32,7 +34,7 @@ When you come to an open response assessment in the course, you'll see the quest
    :alt: Open response assessment example with question, response field, and assessment types and status labeled
    :width: 550
 
-Here, we'll walk you through the process of completing an open response assessment that includes a peer assessment and a self assessment:
+Here, we'll walk you through the process of completing an open response assessment that includes a student training step, a peer assessment, and a self assessment:
 
 #. Submit your response to a question.
 #. Learn to assess responses.
@@ -77,7 +79,7 @@ Note that you can view your response at any time after you submit it. To do this
 Submit an Image with Your Response
 ***********************************
 
-Some assignments require you to submit an image with your text response. If you have to submit an image, you'll see buttons that you'll use to upload your image.
+Some assignments allow you to submit an image with your text response. If you can submit an image, you'll see buttons that you'll use to upload your image.
 
 .. image:: /Images/PA_Upload_ChooseFile.png 
    :alt: Open response assessment example with Choose File and Upload Your Image buttons circled
@@ -89,7 +91,7 @@ To upload your image:
 #. In the dialog box that opens, select the file that you want, and then click **Open**.
 #. When the dialog box closes, click **Upload Your Image**.
 
-Your image appears below the response field, and the name of the image file appears next to the **Choose File** button. If you want to change the image, follow steps 1-3 again.
+Your image appears below the response field, and the name of the image file appears next to the **Choose File** button. If you want to change the image, follow steps 1-3 again. You can only upload one image.
 
 .. image:: /Images/PA_Upload_WithImage.png
    :alt: Example response with an image of Paris
@@ -152,16 +154,32 @@ When peer assessment starts, you'll see the original question, another student's
 
 You'll assess these responses by selecting options in the rubric, the same way you assessed the sample responses in the "learn to assess responses" step. Additionally, this step has a field below the rubric where you can provide comments about the student's 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.
+.. 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, both criteria have a **Comments** field. There is also a field for overall comments on the response.
 
-    .. image:: /Images/PA_S_CommentBoxes.png
-       :alt: Rubric with call-outs for comment boxes
-       :width: 500
+    .. image:: /Images/PA_CriterionAndOverallComments.png
+       :alt: Rubric with comment fields under each criterion and under overall response
+       :width: 600
 
 After you've selected options in the rubric and provided additional comments about the response in this field, click **Submit your assessment and move to response #<number>**.
 
 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 step is updated as you assess each response.
 
+Assess Additional Peer Responses
+********************************
+
+You can assess more peer responses if you want to. After you assess the required number of responses, the step "collapses" so that just the **Assess Peers** heading is visible. 
+
+.. image:: /Images/PA_PAHeadingCollapsed.png
+   :width: 500
+   :alt: The peer assessment step with just the heading visible
+
+To assess more responses, click the **Assess Peers** heading to expand the step. Then, click **Continue Assessing Peers**.
+
+.. image:: /Images/PA_ContinueGrading.png
+   :width: 500
+   :alt: The peer assessment step expanded so that "Continue Assessing Peers" is visible
+
+
 =====================
 Assess Your Response
 =====================
@@ -201,9 +219,9 @@ If you've assessed the required number of peer responses and completed your self
 Peer Assessment Scoring
 ***********************
 
-Peer assessments are scored by criteria. An individual criterion's score is the median of the scores that each peer assessor gave that criterion. For example, if the Ideas criterion in a peer assessment receives a 10 from one student, a 7 from a second student, and an 8 from a third student, the Ideas criterion's score is 8.
+Peer assessments are scored by criteria. An individual criterion's score is the *median*, not average, of the scores that each peer assessor gave that criterion. For example, if the Ideas criterion in a peer assessment receives a 10 from one student, a 7 from a second student, and an 8 from a third student, the Ideas criterion's score is 8.
 
-A student's final score for a peer assessment is the sum of the median scores for each individual criterion. 
+Your final score for a peer assessment is the sum of the median scores for each individual criterion. 
 
 For example, a response may receive the following scores from peer assessors:
 
@@ -237,4 +255,18 @@ To calculate the final score, the system adds the median scores for each criteri
 
   **Ideas median (8/10) + Content median (8/10) + Grammar median (4/5) = final score (20/25)**
 
-Note, again, that final scores are calculated by criteria, not by individual assessor. Thus the response's score is not the median of the scores that each individual peer assessor gave the response.
+Note, again, that final scores are calculated by criteria, not by assessor. Thus your score is not the median of the scores that each individual peer assessor gave the response.
+
+==================================
+View Top Responses (optional)
+==================================
+
+If the instructor has included a **Top Responses** section, you can see the highest-scoring responses that your peers have submitted. This section only appears after you've completed all the steps of the assignment.
+
+.. image:: /Images/PA_TopResponses.png
+   :alt: Section that shows the text and scores of the top three responses for the assignment
+   :width: 500
+
+
+
+

docs/en_us/course_authors/source/index.rst

@@ -12,5 +12,6 @@ Creating Peer Assessments
    :maxdepth: 2
 
    PeerAssessment
-   PeerAssessment_Students
-   Access_PA_Info
+   CreatePeerAssessment
+   Access_PA_Info
\ No newline at end of file
+   PeerAssessment_Students
\ No newline at end of file