Merge pull request #429 from edx/carol/docs/SOL858

Document ability to preview LMS as a particular student, reset student attempts for problems from RCBs

en_us/shared/building_and_running_chapters/cohorts/cohorted_courseware.rst

@@ -32,15 +32,15 @@ Example`.
 
 Complete these steps to create cohort-specific content in your course.
 
-In Studio:
+In Studio
 
 #. :ref:`Enable cohorts in your course<Enabling and Configuring Cohorts>`.
 #. :ref:`Create content groups<Creating Content Groups>`. 
 #. :ref:`Specify components in courseware as visible only to particular content
    groups<Specify Components in Courseware as Visible Only to Certain Content
    Groups>`.
 
-In the LMS: 
+In the LMS
 
 #. :ref:`Assign learners to cohorts<Options for Assigning Learners to
    Cohorts>`.
@@ -331,7 +331,7 @@ content intended for them.
    details about previewing courseware in general, see :ref:`Preview Course
    Content`.
 
-You can view the course as a member of these groups:
+You can view the course as a member of these groups.
 
 .. list-table::
     :widths: 15 30
@@ -343,7 +343,12 @@ You can view the course as a member of these groups:
       - You see all content in the course, including content that is hidden
         from learners.
     * - Student
-      - You see any content that is intended for all learners.
+      - You see any content that is intended for all
+        students.
+    * - Specific Student
+      - Viewing content as a specific student is not available for any content
+        that is visible only to a particular group (content groups and
+        experiment groups).
     * - Student in <Content Group Name>            
       - You see content that is intended for all learners, as well
         as any content specifically set to be visible to this content group.

en_us/shared/building_and_running_chapters/creating_content/libraries.rst

@@ -32,7 +32,7 @@ content libraries<Enable Content Libraries>` in your course, you can use these
 library components in randomized assignments in your course. You do this by
 adding a randomized content block to a course unit and specifying the name of
 the library from which the randomized content is to drawn. You also specify the
-number and type of problems that each learner is assigned.
+number and type of problems that each learner is assigned. For information about randomized content blocks, see :ref:`Randomized Content Blocks`.
 
 Libraries have separate users and levels of access from courses. Initially,
 only the person who created the library has access. She can add other users to
@@ -198,8 +198,15 @@ You can navigate through the pages in the following ways.
 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 as a learner would see it, see :ref:`View the
-Randomized Content as a Student`.
+To view the randomized content that was assigned to a specific learner, see
+:ref:`Specific Student View`. 
+
+.. note:: You cannot use the **Specific student** view for any course content
+   that is visible only to certain groups. For example, if your course uses
+   cohorts or experiment groups, and some courseware is visible only to
+   learners in a particular content group or experiment group, you cannot see
+   that content when you view the live course as a specific student.
+
 
 .. _Edit Components in a Library:
 

en_us/shared/building_and_running_chapters/developing_course/course_units.rst

@@ -358,6 +358,8 @@ When you are revising a previously published unit, it is helpful to preview
 your changes in one window and :ref:`view the published unit<View a Published
 Unit>` in a second window.
 
+For more information about previewing courseware, see :ref:`Preview Course Content`.
+
 .. _Publish a Unit:
 
 ****************************

en_us/shared/building_and_running_chapters/developing_course/testing_courseware.rst

@@ -4,16 +4,15 @@
 Testing Your Course Content
 ###########################
 
-The way your course looks in Studio is not the way that students will see and
-experience it when it is live. 
+The way your course looks in Studio is different from the way that learners
+will see and experience it when it is live.
 
 It is recommended that you test your content continually as you build your
-course, so you can interact with your course from a student's point of view.
+course, so you can interact with your course from a learner's point of view.
 
-To test your content, you can:
-
-* `Preview Course Content`_
-* `View Your Live Course`_
+.. contents::
+  :local:
+  :depth: 2
 
 .. note:: If you use content groups in your course to designate content as
   visible only to particular students, see :ref:`Preview Cohort Specific
@@ -22,6 +21,8 @@ To test your content, you can:
 For information about setting up a beta test for your course, see
 :ref:`Beta_Testing`.
 
+
+
 .. _Preview Course Content:
 
 *************************
@@ -32,16 +33,24 @@ You can preview course content before a course is live or before you publish
 specific units, to test how content will appear to students when it is
 released.
 
-When you preview course content, you see the latest course content configured
-in Studio. You see content in units with the publishing status :ref:`Draft
-(Never Published)`, :ref:`Draft (Unpublished Changes)`, or :ref:`Visible to
-Staff Only`.
-
-If you use content groups and have designated components in a unit as visible
-only to particular groups, the visibility status indicates that some content in
-the unit is visible only to particular groups. For information about previewing
-course content if you use content groups to designate content as visible only to
-particular groups, see :ref:`Preview Cohort Specific Courseware`.
+When you preview course content, you see the latest course content that is
+configured in Studio. You see content in units with the publishing status
+:ref:`Draft (Never Published)`, :ref:`Draft (Unpublished Changes)`, or
+:ref:`Visible to Staff Only`.
+
+.. note:: If you use content groups and have designated components in a unit
+   as visible only to particular groups, the visibility status indicates that
+   some content in the unit is visible only to particular groups. For
+   information about previewing course content if you use content groups to
+   designate content as visible only to particular groups, see :ref:`Preview
+   Cohort Specific Courseware`.
+
+.. note:: If you use randomized content blocks in your courseware, you cannot
+   preview unpublished units that contain content from randomized content
+   blocks, because the randomized content is not assigned until after the unit
+   is published. For information about viewing the actual content that has
+   been assigned to a particular student from a randomized content block in a
+   live course, see :ref:`Specific Student View`.
 
 For example, you :ref:`publish a unit<Publish a Unit>` with a video and a
 discussion.
@@ -63,7 +72,6 @@ look to students by previewing the unit in the LMS.
    discussion component below the multiple choice problem is not included in
    the screen capture).
 
-
 When you click **Preview** and select to view the course as a **Student**, you
 see the unit in the LMS with the multiple choice question. This preview shows
 how students will experience the unit after you :ref:`publish the
@@ -74,7 +82,6 @@ change<Publish a Unit>`.
   a multiple choice problem. (The discussion component below the multiple
   choice problem is not included in the screen capture).
 
-
 In the live course, students continue to see the existing content, without the
 multiple choice question, until you :ref:`publish the change<Publish a Unit>`.
 
@@ -90,36 +97,70 @@ multiple choice question, until you :ref:`publish the change<Publish a Unit>`.
 View Your Live Course
 ******************************************
 
-When you are working in Studio, you can test your course by viewing it in the
-LMS. In the LMS, you can see your course as a student sees it. You can see your
-course in `Staff View`_ or `Student View`_. If you are using content groups to
-designate specific content as visible only to particular content groups, you can
-see your course as a content group would see it.
-
-While you work in Studio, you can switch to your live course to see how your
-course appears to students in two ways.
-
-* From the outline page, click **View Live**.
+While you are working in Studio, you can test your live course by viewing it
+in the LMS as all students, or a particular student, would see it. You can see
+your course in `Staff View`_, `Student View`_, or `Specific Student View`_. If
+you are using content groups to designate specific content as visible only to
+particular content groups, you can see your course as a content group would
+see it.
+
+You can view the course as a member of these groups.
+
+.. list-table::
+    :widths: 15 30
+    :header-rows: 1
+
+    * - Role
+      - When You "View As" This Role
+    * - Staff
+      - You see all content in the course, including content
+        that is hidden from students.
+    * - Student
+      - You see any content that is intended for all
+        students.
+    * - Specific Student
+      - You see content that is intended for the student whose email or
+        username you specify. NOTE: Viewing content as a specific student is
+        not available for any content that is visible only to a particular
+        group (content groups and experiment groups).
+    * - Student in <Content Group Name>            
+      - You see content that is intended for all students, as well
+        as any content specifically set to be visible to this content group.
+
+To switch to your live course and see how it appears to members of the groups
+in the table above, follow these steps.
+
+#. From the course outline page in Studio, click **View Live** or, from a unit page in Studio, click **View Live Version**. 
 
   .. image:: ../../../shared/building_and_running_chapters/Images/test-outline-view-live.png
    :alt: View live button on the outline
-
-* In a unit page, click **View Live Version**.
 
   .. image:: ../../../shared/building_and_running_chapters/Images/test-unit-view-live.png
    :alt: View Live Version button on the unit page
 
+#. In the live view of the course in the LMS, from the navigation bar at the
+   top of the page, select one of the options in the **View this course as**
+   drop down list, as described in the table above.
+
+The course view refreshes and the content is presented as a member of the
+selected group would see it.
+
+For details about each view, see `Staff View`_, `Student View`_, or `Specific
+Student View`_.
+
+
+.. _Staff View:
+
 =================
 Staff View
 =================
 
-You see the course in the **Staff View**.
+In the LMS, to view your live course as anyone with the role of **Staff**
+would see it, use **Staff View**.
 
 .. image:: ../../../shared/building_and_running_chapters/Images/Live_Course_Staff_View.png
  :alt: Image of the Courseware page in a live course with Staff View indicated
   at top right and a View Unit in Studio button
-
-In **Staff View**:
 
 * You see all units that are :ref:`Published and Live`. For units that are
   :ref:`Draft (Unpublished Changes)` or :ref:`Visible to Staff Only`, you
@@ -139,12 +180,14 @@ date of a subsection, members of the course team can work through the problems
 to verify that the correct answer gets a green check for correct, and that any
 answer other than the correct one gets a red X for incorrect.
 
+.. _Student View:
+
 ============
 Student View
 ============
 
-When viewing your course in the LMS, you can use the **Student** view to see the
-course with all course content that is intended for all students.
+In the LMS, to see the course content in your live course that is intended for
+all students, use the **Student** view.
 
 .. note:: If you have enabled your course for cohorts and have designated some
   content as visible only to certain content groups, you can select a content
@@ -156,10 +199,9 @@ To switch to the **Student** view, click **View this course as** and select
 **Student** from the drop down list.
 
 .. image:: ../../../shared/building_and_running_chapters/Images/test-view-as-student.png
- :alt: Image of the View Course As drop down list with Staff, Student, and
-  named content group options
+ :alt: Image of the "View Course As" dropdown list with Staff, Student, and
+  named content group options shown.
 
-In **Student View**:
 
 * You do not see sections or subsections that have not yet been released.
 
@@ -174,6 +216,52 @@ In **Student View**:
 * You can access the Instructor Dashboard, which has features and reports that
   help you run your course.
 
+.. _Specific Student View:  
+
+=====================
+Specific Student View
+=====================
+
+
+In the LMS, the course content in your live course as one particular student
+would see it, use the **Specific student** view.
+
+Seeing the content in your live course as a specific student sees it is useful
+in some situations. For example, to adjust a grade or reset the attempts for a
+problem that was assigned from a randomized content block, you will need to
+view the courseware as a specific student to see the actual problems that they
+were assigned. For details about adjusting grades or resetting attempts, see
+:ref:`Adjust_grades`.
+
+.. note:: You cannot use the **Specific student** view for any course content
+   that is visible only to certain groups. For example, if your course uses
+   cohorts or experiment groups, and some courseware is visible only to
+   learners in a particular content group or experiment group, you cannot see
+   that content when you view the live course as a specific student.
+
+To switch to the **Specific student** view, click **View this course as**.
+Select **Specific student** from the drop down list, and enter the username or
+the email address of the specific student that you want to view the courseware
+as.
+
+.. image:: ../../../shared/building_and_running_chapters/Images/ViewCourseAsSpecificStudent.png
+ :alt: Image of the "View Course As" dropdown list with Staff, Student, and
+  Specific student options shown, and the field that is used to specify the student's username or email address.
+
+
+* You do not see sections or subsections that have not yet been released.
+
+* If the section and subsection are released, you see units that are
+  :ref:`Published and Live`. For units that are
+  :ref:`Draft (Unpublished Changes)`, you see the last published version of the
+  unit. 
+
+* You do not see units that are :ref:`Draft (Never Published)` or
+  :ref:`Visible to Staff Only`. To see these units, you must switch back to Staff view or use Preview mode as described in :ref:`Preview Course Content`.
+
+* You can access the Instructor Dashboard, which has features and reports that
+  help you run your course.
+
 
 *************************************
 Open Studio from Your Live Course