diff --git a/docs/en_us/course_authors/source/Images/Discussion_Add_initial.png b/docs/en_us/course_authors/source/Images/Discussion_Add_initial.png new file mode 100644 index 0000000000..d374f4be10 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/Discussion_Add_initial.png differ diff --git a/docs/en_us/course_authors/source/Images/Discussion_Add_name.png b/docs/en_us/course_authors/source/Images/Discussion_Add_name.png new file mode 100644 index 0000000000..89191618f1 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/Discussion_Add_name.png differ diff --git a/docs/en_us/course_authors/source/Images/Discussion_Add_paste.png b/docs/en_us/course_authors/source/Images/Discussion_Add_paste.png new file mode 100644 index 0000000000..dc43e6b34b Binary files /dev/null and b/docs/en_us/course_authors/source/Images/Discussion_Add_paste.png differ diff --git a/docs/en_us/course_authors/source/Images/NewCategory_Discussion.png b/docs/en_us/course_authors/source/Images/NewCategory_Discussion.png index 28d0b1e755..d8af845372 100644 Binary files a/docs/en_us/course_authors/source/Images/NewCategory_Discussion.png and b/docs/en_us/course_authors/source/Images/NewCategory_Discussion.png differ diff --git a/docs/en_us/course_authors/source/change_log.rst b/docs/en_us/course_authors/source/change_log.rst index e1604ec2f6..f09999c37b 100644 --- a/docs/en_us/course_authors/source/change_log.rst +++ b/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 diff --git a/docs/en_us/course_authors/source/running_course/discussions.rst b/docs/en_us/course_authors/source/running_course/discussions.rst index de498703d6..de3e4c4849 100644 --- a/docs/en_us/course_authors/source/running_course/discussions.rst +++ b/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" - | } - | } + .. image:: ../Images/Discussion_Add_initial.png + :alt: Policy value of {"General": {"id": "i4x-test_doc-SB101-course-2014_Jan"}} -4. Add a comma between the two closing braces. +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" - | }, - | } + .. 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"}} +5. Replace the second "General" with the quoted name of your new discussion category. -5. Copy the three lines provided for the General discussion category and paste them above the closing brace: +#. Change the second id value to a unique identifier. For example, append a reference to the category name. - | { - | "General": { - | "id": "i4x-test_doc-SB101-course-2014_Jan" - | }, - | "General": { - | "id": "i4x-test_doc-SB101-course-2014_Jan" - | } - | } +#. Add a comma between the two closing braces. -6. 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: - - - | { - | "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`.