Merge pull request #3188 from edx/ahodges/documentation/UTF8

Ahodges/documentation/utf8

docs/en_us/course_authors/source/change_log.rst

@@ -10,6 +10,8 @@ Change Log
 
    * - Date
      - Change  
+   * - 4/7/14
+     - Expanded the :ref:`Course Data`, :ref:`Enrollment`, and :ref:`Course_Staffing` sections.
    * - 04/03/14
      - Updated the :ref:`Adding Pages to a Course` chapter to reflect ability to
        :ref:`Show or Hide the Course Wiki Page`.

docs/en_us/course_authors/source/running_course/course_data.rst

@@ -4,7 +4,8 @@
 Course Data
 ############################
 
-After you create a course, you can access information about it from the Instructor Dashboard. You can find:
+After you create a course, you can access information about it from the
+Instructor Dashboard. You can find:
 
 * Identifying information for the course.
 
@@ -12,6 +13,10 @@ After you create a course, you can access information about it from the Instruct
 
 * The defined grade cutoff for passing or failing.
 
+*************************************************
+Review Course Data
+*************************************************
+
 To view course data:
 
 #. View the live version of your course.
@@ -20,7 +25,54 @@ To view course data:
 
 #. Click **Course Info** if necessary. 
 
-   The Basic Course Information section of the page that opens lists information for the course.
+   The **Basic Course Information** section of the page that opens lists
+   information about the course.
+
+    .. image:: ../Images/Instructor_Dash_Course_Info.png
+     :alt: The basic course information section of the Instructor Dashboard 
+
+*************************************************
+Sources in Studio of the Basic Course Information
+*************************************************
+
+The course data that displays on the Instructor Dashboard is defined in
+Studio, or derived from data that you define in Studio.
+
+* **Organization**: Specified in Studio when you create the course. Becomes
+  part of the course URL, and cannot be changed.
+
+* **Course Number**: Specified in Studio when you create the course. Becomes
+  part of the course URL, and cannot be changed.
+
+* **Course Name**: Specified in Studio when you create the course. Becomes
+  part of the course URL, and cannot be changed. In Studio, this field is
+  labeled **Course Run**.
+
+* **Course Display Name**: Specified in Studio when you create the course. In
+  Studio, this field is labeled **Course Name**. 
+
+  This name can be changed in Studio (not recommended if your course is live):
+  select **Settings** > **Advanced Settings** and scroll down to the policy key
+  labeled **display_name**. This setting changes the **Course Display Name** in the LMS only. 
+
+  The illustration that follows shows the information collected by Studio for
+  a new course side-by-side with the same information in the **Basic Course
+  Information** section of the Instructor Dashboard.
+
+.. image:: ../Images/Course_Info_Comparison.png
+   :alt: The Course Name in Studio and the Course Display Name in the LMS are boxed; the Course Run in Studio and the Course Name in the LMS are circled
+   :width: 800
+
+* **Has the course started**: Derived from the **Course Start Date** and the
+  current date. This date can be changed in Studio (not recommended if your
+  course is live): select **Settings** > **Schedule & Details**.
+
+* **Has the course ended**: Derived from the **Course End Date** and the
+  current date. This date can be changed in Studio (not recommended if your
+  course is live): select **Settings** > **Schedule & Details**.
 
-.. You also use the Instructor Dashboard to set up the staff for your course, enroll students and access student data, and initiate, review, and adjust grades.
+* **Grade Cutoffs**: Specified in Studio when you define the cutoff for a
+  failing grade. Students who earn exactly the cutoff value pass the course.
+  Grading can be changed in Studio (not recommended if your course is live):
+  select **Settings** > **Grading**.
 

docs/en_us/course_authors/source/running_course/course_grades.rst

@@ -296,11 +296,11 @@ Entries are sorted by the value in each column, starting with the ModuleID on th
 
 Please note the following about the student answer distribution report:   
 
-* This report includes only problems that at least one student has answered since early March 2014. For those problems, this report only includes activity that occurred after October 2013. 
+* This report includes only problems that at least one student has answered since 6 March 2014. For those problems, this report only includes activity that occurred after October 2013. 
 
-* For checkboxes and multiple choice problems, the answer choices actually selected by a student after early March 2014 display as described above. Answer choices selected by at least one student after October 2013, but not selected since early March 2014, are included on the report but do not include an **AnswerValue**. The **ValueID** does display the internal identifiers, such as choice_1 and choice_2, for those answers. 
+* For checkboxes and multiple choice problems, the answer choices actually selected by a student after 6 March 2014 display as described above. Answer choices selected by at least one student after October 2013, but not selected since 6 March 2014, are included on the report but do not include an **AnswerValue**. The **ValueID** does display the internal identifiers, such as choice_1 and choice_2, for those answers. 
 
-* For problems that use the **Randomization** setting in Studio, if a particular answer has not been selected since early March 2014, the **Question** is blank for that answer.
+* For problems that use the **Randomization** setting in Studio, if a particular answer has not been selected since 6 March 2014, the **Question** is blank for that answer.
 
 * Problem **Count** values reflect the entire problem history. If you change a problem after it is released, it may not be possible for you to determine which answers were given before and after you made the change.
 

docs/en_us/course_authors/source/running_course/course_staffing.rst

@@ -4,25 +4,35 @@
 Staffing
 ##########################
 
-You can designate a team of people to help you run your course. Two roles are available to give your team members access to different options for working with students, grades, and other course staff.
+You can designate a team of people to help you run your course. Two roles are
+available to give your administrative team members access to different options
+for working with students, grades, and other members of the staff.
 
-* Staff members
+* Course Staff
 
 * Instructors
 
 .. **Question**: how does this team, set up on the Instructor Dashboard, differ from the "Course Team Members" that you add in Studio (Settings > Course Team)?
 
-You can also designate people to help you beta test a course and to moderate and manage discussions. Beta testers and discussion administrators must be enrolled in your course, but you do not need to give them a staff role. For more information, see :ref:`Assigning_discussion_roles`. 
+The administrative team that helps you run your course in the LMS can include
+some, all, or none of the people who help you set up the course in Studio. You
+assign these administrative roles in the LMS, separately from the roles you
+assign in Studio. For more information on setting up a team in Studio, see
+:ref:`Add Course Team Members`.
 
-.. insert ":ref:`Beta_Testing` and " above after "see"
+You can also designate teams of people to beta test your course and to
+moderate and manage its discussions by assigning other LMS roles. The beta
+testers and discussion administrators must be enrolled in your course, but
+they do not need to have the Course Staff or Instructors role or a Studio
+role. For more information, see :ref:`Beta_Testing` and
+:ref:`Assigning_discussion_roles`.
 
-You use these roles to define the team that helps you run your course. To help you develop a course in Studio, you set up a team in Studio. For more information, see :ref:`Add Course Team Members`.
+****************************
+Administrative Team Roles
+****************************
 
-**********************
-Staff roles
-**********************
-
-To provide access to features on the LMS Instructor Dashboard you assign the Course Staff role or the Instructor role.
+To provide access to features on the LMS Instructor Dashboard you assign the
+Course Staff role or the Instructors role.
 
 **Course Staff** can: 
 
@@ -40,25 +50,27 @@ To provide access to features on the LMS Instructor Dashboard you assign the Cou
 
 **Instructors** have access to all of the same options for running the course as the course staff. They can also:
 
-* Add and remove course staff.
+* Add and remove Course Staff.
 
-* Add and remove other instructors.
+* Add and remove other Instructors.
 
-* Add and remove beta testers.
+* Add and remove Beta Testers.
 
-* Add and remove discussion forum admins, moderators, and community TAs.
+* Add and remove Discussion Admins, Discussion Moderators, and Discussion
+  Community TAs.
 
 .. 12 Feb 14 Sarina: This all sounds right but there are other tasks (rescoring, etc) not mentioned. Probably worth nailing down what tasks can and cannot be done by a course staff.
 
 **********************
-Assign staff roles 
+Assign Staff Roles 
 **********************
 
-Before you can assign the course staff or instructor role to a team member:
+Before you can assign the Course Staff or Instructors role to a team member:
 
 * You need the email address or username of each team member. 
 
-* Each team member must register a user account for that email address/username and enroll in your course.
+* Each team member must register a user account for that email
+  address/username, activate the account, and enroll in your course.
 
 To assign a staff role:
 
@@ -68,9 +80,12 @@ To assign a staff role:
 
 #. Click **Membership**.
 
-#. In the Administration List Management section, use the drop-down list to select **Course Staff** or **Instructors**.
+#. In the **Administration List Management** section, use the drop-down list to
+   select **Course Staff** or **Instructors**.
 
-#. Under the list of users who currently have that role, enter an email address or username and click **Add** for the role type.
+#. Under the list of users who currently have that role, enter an email
+   address or username and click **Add** for the role type.
 
-To remove an assigned role, view the list of users and then click **Revoke access**. 
+To remove an assigned role, view the list of users and then click **Revoke
+access**.