Merge pull request #86 from edx/sylviapearce/documentation/TIM-160

Sylviapearce/documentation/tim 160

apps/openassessment/templates/openassessmentblock/grade/oa_grade_closed.html

@@ -4,6 +4,6 @@
 
     <div class="openassessment__grade__content">
         <span class="grade__value">Incomplete</span>
-        <p>You did not complete the <span class="step">Peer Assessment</span>, and <span class="step">Self Assessment</span> portions of this problem.</p>
+        <p>You did not complete the <span class="step">Peer Assessment</span> and <span class="step">Self Assessment</span> steps of this problem.</p>
     </div>
 </div>
\ No newline at end of file

apps/openassessment/templates/openassessmentblock/grade/oa_grade_incomplete.html

@@ -4,6 +4,6 @@
 
     <div class="openassessment__grade__content">
         <span class="grade__value">Incomplete</span>
-        <p>You have not completed the <span class="step">Peer Assessment</span>, and <span class="step">Self Assessment</span> portions of this problem.</p>
+        <p>You have not completed the <span class="step">Peer Assessment</span> and <span class="step">Self Assessment</span> steps of this problem.</p>
     </div>
 </div>
\ No newline at end of file

apps/openassessment/templates/openassessmentblock/grade/oa_grade_waiting.html

@@ -4,6 +4,6 @@
 
     <div class="openassessment__grade__content">
         <span class="grade__value">Waiting for Peers to Assess Your Response</span>
-        <p>Your response is still being evaluated by your peers. Once complete, you will receive a final grade and detailed feedback from their evaluations.</p>
+        <p>Your response is still undergoing peer assessment. After your peers have assessed your response, you'll see their feedback and receive your final grade.</p>
     </div>
 </div>
\ No newline at end of file

apps/openassessment/templates/openassessmentblock/oa_base.html

@@ -19,7 +19,7 @@
                 </span>
 
                 <span class="openassessment__title--sub">
-                    <span class="problem-type problem-type--open-ended-response">Open Ended Response</span>
+                    <span class="problem-type problem-type--open-ended-response">Open Response</span>
                     {%  for assessment in rubric_assessments %}
                     +
                     <span class="problem-type problem-type--{{ assessment.type }}">{{ assessment.name }}</span>
@@ -29,7 +29,7 @@
 
             <!--?: may have trouble with aync -->
             <nav class="nav--contents">
-                <h2 class="title">Skip to a part of this problem:</h2>
+                <h2 class="title">Skip to a specific step:</h2>
 
                 <ol class="list list--nav">
                     {%  for assessment in rubric_assessments %}
@@ -50,7 +50,7 @@
             <div class="wrapper--openassessment__prompt">
                 <article class="openassessment__prompt ui-toggle-visibility">
 
-                    <h2 class="openassessment__prompt__title">Open Assessment Problem</h2>
+                    <h2 class="openassessment__prompt__title">Open Response Assessment Problem</h2>
 
                     <div class="openassessment__prompt__copy ui-toggle-visibility__content">
                         <p>{{ question }}</p>

apps/openassessment/templates/openassessmentblock/peer/oa_peer_assessment.html

@@ -9,7 +9,7 @@
         <h2 class="step__title">
             <span class="step__counter"></span>
             <span class="wrapper--copy">
-                <span class="step__label">Evaluate Peers' Responses</span>
+                <span class="step__label">Assess Peers' Responses</span>
                 <span class="step__deadline">due <span class="date">{{ formatted_due_datetime }}</span></span>
             </span>
         </h2>
@@ -30,7 +30,7 @@
     {% block body %}
     <div class="ui-toggle-visibility__content">
         <div class="step__instruction">
-            <p>Please read and evaluate the following response from one of your peers in the course.</p>
+            <p>Please read and assess the following response from one of your peers.</p>
         </div>
 
         <div class="step__content">
@@ -45,7 +45,7 @@
                                 </h3>
 
                                 <span class="peer-assessment__expected-time">
-                                    <span class="label">Expected Time Spent:</span>
+                                    <span class="label">Expected Time:</span>
                                     <span class="value">{{ estimated_time }}</span>
                                 </span>
                             </header>
@@ -94,7 +94,7 @@
                                     <li class="wrapper--input field field--textarea assessment__rubric__question assessment__rubric__question--feedback" id="assessment__rubric__question--feedback">
                                         <label class="question__title" for="assessment__rubric__question--feedback__value">
                                             <i class="ico fa fa-caret-right"></i>
-                                            <span class="question__title__copy">Please provide any other feedback you have around this response</span>
+                                            <span class="question__title__copy">Please provide additional feedback for this response.</span>
                                         </label>
                                         <textarea id="assessment__rubric__question--feedback__value" placeholder="I felt this response was..."></textarea>
                                     </li>

apps/openassessment/templates/openassessmentblock/response/oa_response.html

@@ -27,7 +27,7 @@
     {% block body %}
     <div class="ui-toggle-visibility__content">
         <div class="step__instruction">
-            <p>Please provide your response to the following question. You may save your progress and return to complete your response anytime before the due date of <span class="step__deadline">due <span class="date">{{ formatted_due_date }}</span></span>. <strong class="emphasis--beta">Once you submit, you may not edit your response</strong>.</p>
+            <p>Please provide your response to the following question. You can save your progress and return to complete your response at any time before the due date of <span class="step__deadline"><span class="date">{{ formatted_due_date }}</span></span>. <strong class="emphasis--beta">After you submit your response, you cannot edit it</strong>.</p>
         </div>
 
         <div class="step__content">
@@ -36,7 +36,7 @@
             <form id="response__submission" class="response__submission">
                 <ol class="list list--fields response__submission__content">
                     <li class="field field--textarea submission__answer" id="submission__answer">
-                        <label class="sr" for="submission__answer__value">Please provide your response to the above question</label>
+                        <label class="sr" for="submission__answer__value">Please provide your response to the question.</label>
                         <textarea id="submission__answer__value" placeholder="">{{ saved_response }}</textarea>
                     </li>
                 </ol>
@@ -44,7 +44,7 @@
                 <ul class="list list--actions response__submission__actions">
                     <li class="list--actions__item">
                         <button type="submit" id="submission__save" class="action action--save submission__save">Save Your Progress</button>
-                        <span class="tip">you may continue to work on your response until you submit</span>
+                        <span class="tip">You may continue to work on your response until you submit it.</span>
                     </li>
                 </ul>
             </form>
@@ -54,7 +54,7 @@
             <ul class="list list--actions">
                 <li class="list--actions__item">
                     <a aria-role="button" href="#" id="step--response__submit" class="action action--submit step--response__submit">
-                        <span class="copy">Submit your response &amp; move forward</span>
+                        <span class="copy">Submit your response and move to the next step</span>
                         <i class="ico fa fa-arrow-right"></i>
                     </a>
                 </li>

apps/openassessment/templates/openassessmentblock/response/oa_response_closed.html

@@ -16,7 +16,7 @@
 {% block body %}
 <div class="ui-toggle-visibility__content">
   <div class="step__instruction">
-      <p>You did not complete this portion of the problem before its due date.</p>
+      <p>You did not complete this step before the problem's due date.</p>
   </div>
 </div>
 {% endblock %}

apps/openassessment/templates/openassessmentblock/response/oa_response_graded.html

@@ -26,7 +26,7 @@
         </article>
 
         <article class="submission__peer-evaluations">
-            <h3 class="submission__peer-evaluations__title">Peer Evaluations Of Your Response</h3>
+            <h3 class="submission__peer-evaluations__title">Peer Assessments of Your Response</h3>
 
             <ol class="list submission__peer-evaluations__questions">
             {% for criterion in rubric_criteria %}
@@ -55,11 +55,11 @@
                         id="question--{{ criterion_num }}__answer-{{ peer_num }}">
                         <h5 class="answer__title">
                             <span class="answer__source">
-                              <span class="label sr">Assessor: </span>
+                              <span class="label sr">Peer Assessor: </span>
                               <span class="value">Peer {{ peer_num }}</span>
                             </span>
                             <span class="answer__value">
-                              <span class="label sr">Peer's Assessment: </span>
+                              <span class="label sr">Assessment: </span>
                               <span class="value">{{ part.option.name }}</span>
                             </span>
                         </h5>
@@ -80,18 +80,18 @@
         </article>
 
         <form id="submission__feeedback" class="submission__feeedback ui-toggle-visibility" method="post">
-            <h3 class="submission__feeedback__title ui-toggle-visibility__control">Give Feedback On Peer Evaluations</h3>
+            <h3 class="submission__feeedback__title ui-toggle-visibility__control">Provide Feedback on Peer Assessments</h3>
 
             <ol class="list list--fields submission__feeedback__content ui-toggle-visibility__content">
                 <li class="field field--textarea feedback__remarks" id="feedback__remarks">
-                    <label for="feedback__remarks__value">Please provide any thoughts or comments on the feedback you received from your peers here.</label>
-                    <textarea id="feedback__remarks__value" placeholder="I feel the feedback I received was..."></textarea>
+                    <label for="feedback__remarks__value">Please provide feedback on the score and comments you received from your peers.</label>
+                    <textarea id="feedback__remarks__value" placeholder="I feel the score and comments I received were..."></textarea>
                 </li>
             </ol>
 
             <ul class="list list--actions submission__feeedback__actions">
                 <li class="list--actions__item">
-                    <button type="submit" id="feedback__submit" class="action action--submit feedback__submit">Submit Feedback On Peer Evaluations</button>
+                    <button type="submit" id="feedback__submit" class="action action--submit feedback__submit">Submit Feedback on Peer Assessments</button>
                 </li>
             </ul>
         </form>

apps/openassessment/templates/openassessmentblock/self/oa_self_assessment.html

@@ -11,7 +11,7 @@
         <h2 class="step__title">
             <span class="step__counter"></span>
             <span class="wrapper--copy">
-                <span class="step__label">Evaluate Your Response</span>
+                <span class="step__label">Assess Your Response</span>
                 <span class="step__deadline">due <span class="date">{{ formatted_due_datetime }}</span></span>
             </span>
         </h2>