DOC-279, correct add discussion category steps

also removed "static" for pages

docs/en_us/course_authors/source/change_log.rst

@@ -14,18 +14,21 @@ April, 2014
      - Change  
    * - 04/22/14
      - Updated the :ref:`Bulk Email` section with information about the dashboard option to opt out of course email. 
-   * - 4/16/14
-     - Updated "Transcripts in Additional Languages" in :ref:`Working with Video Components`.
+   * - 
+     - In :ref:`Discussions`, corrected the steps to "Create" Discussion
+       Categories".
    * - 04/16/14
+     - Updated "Transcripts in Additional Languages" in :ref:`Working with Video Components`.
+   * -  
      - In support of new features, added the following sections to :ref:`Multiple Choice` problems:
 
        * :ref:`Shuffle Answers in a Multiple Choice Problem`
        * :ref:`Targeted Feedback in a Multiple Choice Problem`
        * :ref:`Answer Pools in a Multiple Choice Problem`
 
-   * - 4/15/14
+   * - 04/15/14
      - Updated :ref:`Testing Your Course` to include a section on how to :ref:`View Your Live Course`.
-   * - 4/11/14
+   * - 04/11/14
      - Expanded the :ref:`Grades` section to include a topic on interpreting the Student Answer Distribution report. 
    * - 04/08/14
      - Updated the chapter :ref:`Working with HTML Components` to reflect the
@@ -63,9 +66,9 @@ March, 2014
    * - 03/27/14
      - Updated the :ref:`Adding Pages to a Course` section to reflect feature
        changes.
-   * - 3/27/14
+   * - 03/27/14
      - Updated the section on :ref:`Beta_Testing` to include the new "batch add" feature.
-   * - 3/19/14
+   * - 03/19/14
      - Updated the sections on :ref:`Beta_Testing`, :ref:`Discussions`,
        :ref:`Grades`, and :ref:`Student Data` with changes to the new Instructor Dashboard.
    * - 03/17/14

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

@@ -35,7 +35,8 @@ This type of discussion is subject to the release date of the section that conta
 =====================================
 Create discussion categories
 =====================================
-All courses have a static page named **Discussion**. When you create a course, a discussion category named General is available for you to include by default. You can add more discussion categories to guide how students share and find information during your course. Categories might include Feedback, Troubleshooting, or Technical Help. Discussions in these categories can begin as soon as your course is available.
+
+All courses include a page named **Discussion**. When you create a course, a discussion category named General is available for you to include by default. You can add more discussion categories to guide how students share and find information during your course. Categories might include Feedback, Troubleshooting, or Technical Help. Discussions in these categories can begin as soon as your course is available.
 
 To create a discussion category:
 
@@ -45,52 +46,29 @@ To create a discussion category:
 
 #. Scroll down to the Policy Key labeled **discussion_topics**. By default, its Policy Value is:
 
- | {
- |    "General": {
- |        "id": "i4x-test_doc-SB101-course-2014_Jan"
- |    }
- | }
-
-4. Add a comma between the two closing braces.
-
- | {
- |    "General": {
- |        "id": "i4x-test_doc-SB101-course-2014_Jan"
- |    },
- | }
-
+ .. image:: ../Images/Discussion_Add_initial.png
+  :alt: Policy value of {"General": {"id": "i4x-test_doc-SB101-course-2014_Jan"}}
 
-5. Copy the three lines provided for the General discussion category and paste them above the closing brace:
+4. Copy the three lines provided for the General discussion category and paste them above the closing brace:
 
-  | {
-  |   "General": {
-  |       "id": "i4x-test_doc-SB101-course-2014_Jan"
-  |   },
-  |   "General": {
-  |       "id": "i4x-test_doc-SB101-course-2014_Jan"
-  |   }
-  | }
+ .. image:: ../Images/Discussion_Add_paste.png
+  :alt: Policy value of {"General": {"id": "i4x-test_doc-SB101-course-2014_Jan"} "General": {"id": "i4x-test_doc-SB101-course-2014_Jan"}}
 
-6. Replace the second "General" with the quoted name of your new discussion category.
+5. Replace the second "General" with the quoted name of your new discussion category.
 
-#. Change the second id value to a unique identifier. For example, append a reference to the category name:
+#. Change the second id value to a unique identifier. For example, append a reference to the category name.
 
+#. Add a comma between the two closing braces.
 
- | {
- |   "General": {
- |       "id": "i4x-test_doc-SB101-course-2014_Jan"
- |   },
- |    "Questions about the course": {
- |        "id": "i4x-test_doc-SB101-course-2014_Jan_faq"
- |    }
- | }
+ .. image:: ../Images/Discussion_Add_name.png
+  :alt: Policy value of {"General": {"id": "i4x-test_doc-SB101-course-2014_Jan"}, "Course Q&A": {"id": "i4x-test_doc-SB101-course-2014_Jan_faq"}}
 
 8. Click **Save Changes**.
 
-When students click the **Discussion** static page for your course, the drop-down list includes this new category.
+When students click the **Discussion** page for your course, the drop-down list includes this new category.
 
  .. image:: ../Images/NewCategory_Discussion.png
-  :alt: Image of a new discussion category
+  :alt: Image of a new category named Course Q&A in the list of discussions
 
 .. _Assigning_discussion_roles:
 
@@ -207,7 +185,7 @@ For information on setting up moderators for your course, see :ref:`Assigning_di
 Provide guidelines for students
 ========================================
 
-You can develop a set of best practices for discussion participation and make them avaialbe to students as a course handout file or as a static page. These guidelines can define your expectations and optionally introduce features of edX discussions. 
+You can develop a set of best practices for discussion participation and make them avaiable to students as a course handout file or on a defined page in your course. These guidelines can define your expectations and optionally introduce features of edX discussions. 
 
 .. For a template that you can use to develop your own guidelines, see :ref:`Discussion Forum Guidelines`.