Merge pull request #3137 from edx/markhoeber/documentation/doc-97

Changes for doc-97 - Subsection grading

docs/en_us/course_authors/source/change_log.rst

@@ -9,8 +9,10 @@ Change Log
    :header-rows: 1
 
    * - Date
-     - Change   
-   * - 3/31/14 
+     - Change  
+   * - 04/01/14 
+     - Update the :ref:`Establish a Grading Policy` chapter to emphasize that grading is applied to subsections only. 
+   * - 03/31/14 
      - Expanded the :ref:`Grades` chapter to include the new :ref:`Review_Answers` section.
    * - 03/27/14
      - Updated the :ref:`Add Pages` section to reflect feature changes.

docs/en_us/course_authors/source/creating_content/create_discussion.rst

@@ -8,7 +8,8 @@ Working with Discussion Components
 Overview
 *******************
 
-You can add a Discussion component to a Unit, to pose a question related to the Unit and give students a chance to respond and interact.
+You can add a Discussion component to a Unit, to pose a question related to the
+Unit and give students a chance to respond and interact.
 
 See the following topics:
 
@@ -16,7 +17,10 @@ See the following topics:
 * :ref:`A Student's View of the Discussion`
 
 
-Before you add a Discussion component, it is generally a good idea to add an HTML component that introduces the topic to be discussed. The Discussion component itself does not contain any text and may be easy for students to overlook. 
+Before you add a Discussion component, it is generally a good idea to add an
+HTML component that introduces the topic to be discussed. The Discussion
+component itself does not contain any text and may be easy for students to
+overlook.
 
 Also see the following chapters:
 
@@ -29,11 +33,15 @@ Also see the following chapters:
 Create a Discussion Component 
 *****************************
 
-.. note:: Before you create a Discussion component, consider that Discussion categories are immediately visible in your forum (on the Discussion tab for your course) when you create them, even though the unit that contains the Discussion component is set to Private.
+.. note:: Before you create a Discussion component, consider that Discussion
+ categories are immediately visible in your forum (on the Discussion tab for
+ your course) when you create them, even though the unit that contains the
+ Discussion component is set to Private.
 
 
-To create a new HTML component in an existing Unit, ensure the Unit is Private.  
-For more information on Public and Private Units, see :ref:`Public and Private Units`.
+To create a new Discussion component in an existing Unit, ensure the Unit is
+Private. For more information on Public and Private Units, see :ref:`Public and
+Private Units`.
 
 #. Under **Add New Component**, click the **discussion** icon.
 
@@ -53,33 +61,41 @@ For more information on Public and Private Units, see :ref:`Public and Private U
    .. image:: ../Images/DiscussionComponentEditor.png
     :alt: Image of the discussion component editor
 
-#. Follow the guidelines in the editor to fill in the **Category**, **Display Name**, and **Subcategory**. 
+#. Follow the guidelines in the editor to fill in the **Category**, **Display
+   Name**, and **Subcategory**.
   
 #. Click **Save**.
 
+.. note:: For a Discussion component to be visible in the **Discussion** tab's
+ topic drop-down list, the unit must be published and the section and
+ subsection must have a release date in the past. See :ref:`Publishing Your
+ Course` for more information.
+
 .. _A Student's View of the Discussion:
 
 **********************************
 A Student's View of the Discussion 
 **********************************
 
-For students, Discussion component names appear in the course ribbon at the top of the page:
+For students, Discussion component names appear in the course ribbon at the top
+of the page:
 
 .. image:: ../Images/DiscussionComponent_LMS_Ribbon.png
- :alt: Image of a unit from a student's point of view with the component list showing a discussion component
+ :alt: Image of a unit from a student's point of view with the component list
+     showing a discussion component
 
-The Discussion space appears under other components in the unit. 
-It doesn't have a label in the body of the unit. 
-Instead, students see "Show discussion" or "Hide discussion" on the left, 
-and a blue **New Post** button on the right.
+The Discussion space appears under other components in the unit. It doesn't have
+a label in the body of the unit. Instead, students see "Show discussion" or
+"Hide discussion" on the left, and a blue **New Post** button on the right.
 
-In the following example, the Discussion component follows Video and HTML components:
+In the following example, the Discussion component follows Video and HTML
+components:
 
 .. image:: ../Images/DiscussionComponent_LMS.png
   :alt: Image of a video component followed by a discussion component
 
-In the **Discussion** tab at the top of the page, 
-students can find the category and subcategory of the discussion in the left pane.
+In the **Discussion** tab at the top of the page, students can find the category
+and subcategory of the discussion in the left pane.
 
 .. image:: ../Images/DiscussionComponent_Forum.png
  :alt: Image of the discussion page from a student's point of view