Merge pull request #3376 from edx/sylvia/docs/small_corrections

Sylvia/docs/small corrections

docs/en_us/course_authors/source/building_course/creating_new_course.rst

@@ -20,7 +20,7 @@ You can also :ref:`Export a Course` and :ref:`Import a Course` through Studio.
 You can do this when you need to edit the course in XML.
 
 .. _Edge: http://edge.edx.org
-.. _edX.org: http://edx.org
+.. _edXorg: http://edx.org
 
 .. _Create a New Course:
   
@@ -40,7 +40,7 @@ Create a New Course
    created, you must contact edX through the Help site
    (http://help.edge.edx.org). Additionally, because this information becomes
    part of your course URL, the total number of characters in the following
-   three fields must be 65 or fewer.
+   four fields must be 65 or fewer.
 
   * For **Course Name**, enter the title of your course. For example, the name
     may be “Sets, Maps and Symmetry Groups". Use title capitalization for the

docs/en_us/course_authors/source/building_course/establish_grading_policy.rst

@@ -245,7 +245,7 @@ You can also :ref:`Set the Grace Period` for your assignments to cover any
 misunderstandings about time. For example, some classes have set a grace period
 of 1 day, 6 hours, and 1 minute. The grace period applies to all assignments.
 
-Students see the due date in the course accordian under the subsection title.
+Students see the due date in the course accordion under the subsection title.
 For example:
 
 .. image::  ../Images/Subsection_due_date.png

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

@@ -14,7 +14,7 @@ Unit and give students a chance to respond and interact.
 See the following topics:
 
 * :ref:`Create a Discussion Component`
-* :ref:`A Student's View of the Discussion`
+* :ref:`A Students View of the Discussion`
 
 
 Before you add a Discussion component, it is generally a good idea to add an
@@ -33,51 +33,37 @@ 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.
-
-
 To create a new Discussion component in an existing unit, ensure the unit is
 Private. For more information, see :ref:`Public and
 Private Units`.
 
-#. Under **Add New Component**, click the **discussion** icon.
+#. Under **Add New Component**, click **Discussion**.
 
-   .. image:: ../Images/NewComponent_Discussion.png
-    :alt: Image of the adding a new discussion component
+#. In the Discussion component that appears, click **Edit**.
   
-   The Discussion component is added:
-  
-   .. image:: ../Images/EditDiscussionComponent.png
+   .. image:: ../Images/Disc_Create_Edit.png
     :alt: Image of the discussion component with the Edit button circled
 
-
-#. In the Discussion component, click **Edit**.
-
-   The Discussion component editor opens.
+#. When the Discussion component editor opens, follow the guidelines in the editor to fill in the **Category**, **Display Name**, and **Subcategory** fields.
    
    .. 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**.
   
 #. 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.
+.. warning:: You should always use these steps to create a discussion component. If you create a discussion component by using the **Duplicate** button in Studio, both discussion components will contain the same conversations, even if users post in different discussions.
+
+Discussion *categories* are immediately visible on the **Discussion** tab for your course when you create them, even if the unit that contains the Discussion component is set to Private. However, an individual Discussion component is not visible until the unit is published and release dates for the section and subsection have passed. See :ref:`Publishing Your Course` for more information.
+
+Additionally, you cannot see posts, responses, or comments in a Discussion component when you are working in Studio. To see the discussion, go to the unit that contains the Discussion component in Studio, and then click **Preview** or **View Live** under **Unit Settings**.
 
-.. _A Student's View of the Discussion:
+.. _A Students View of the Discussion:
 
 **********************************
 A Student's View of the Discussion 
 **********************************
 
-For students, Discussion component names appear in the course ribbon at the top
+For students, the display name for the Discussion component appears in the course ribbon at the top
 of the page:
 
 .. image:: ../Images/DiscussionComponent_LMS_Ribbon.png

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

@@ -236,7 +236,7 @@ Set the Display Name for a Component
 
 Each component has a display name that shows in the component header when you
 can edit the component. The display name also shows to students when they hover
-the mouse pointer over the unit icon in the course accordian.
+the mouse pointer over the unit icon in the course accordion.
 
 To set the display name for a component: