Merge pull request #836 from jswope00/jswope00/reorg_educator_engagem…

…ent_communication

Jswope00/reorg educator Learner Engagement & Communication (FC-68)

source/educators/concepts/advanced_features/cohorts_overview.rst

@@ -17,9 +17,9 @@ For more information about setting up and managing cohorts, see the following to
 
 * :ref:`Setting Up Discussions in Courses with Cohorts<Set up Discussions in Cohorted Courses>`
 
-* :ref:`Managing Divided Discussion Topics`
+* :ref:`Guide to Managing Divided Discussions`
 
-For information about discussions in general, see :ref:`Discussions`.
+For information about discussions in general, see :ref:`About Course Discussions`.
 
 For information about offering different content to different cohorts of learners, see :ref:`Offering Different Content Based on Cohort`.
 
@@ -158,11 +158,11 @@ You can check the :ref:`learner profile information report<View Learner Data>` f
 
  :ref:`About Divided Discussions` (concept)
 
- :ref:`Managing Divided Discussion Topics` (concept)
+ :ref:`Guide to Managing Divided Discussions` (reference)
 
- :ref:`Moderating_discussions` (concept)
+ :ref:`Best Practices for Moderating Course Discussions` (concept)
 
- :ref:`Setting Up Divided Discussions` (how-to)
+ :ref:`Set Up Divided Discussions` (how-to)
 
 
 **Maintenance chart**

source/educators/concepts/advanced_features/managing_teams_discussions.rst

@@ -14,8 +14,8 @@ roles for course discussions on the **Discussions** page can perform the same
 roles for discussions in teams.
 
 For information about discussion administration roles, see
-:ref:`Assigning_discussion_roles`. For information about managing discussions,
-see :ref:`Running_discussions`.
+:ref:`Assign discussion roles`. For information about managing discussions,
+see :ref:`Best Practices for Configuring Course Discussions`.
 
 .. contents::
   :local:

source/educators/concepts/advanced_features/teams_learner_experience.rst

@@ -100,7 +100,7 @@ team.
    their team discusssions without regard to the cohort they belong to.
 
 For information about course discussions and managing discussions, see
-:ref:`Discussions` and :ref:`Guidance for Discussion Moderators`.
+:ref:`About Course Discussions` and :ref:`Best Practices for Moderating Course Discussions`.
 
 .. seealso::
 

source/educators/concepts/advanced_features/teams_overview.rst

@@ -35,7 +35,7 @@ and ask learners to join teams of their choice within a specific team-set to com
 the assignment. Team members can use discussions within the team to communicate
 and collaborate on the assignment. If you want only to  provide a way for learners
 to connect socially, consider using discussions within the course rather than teams.
-For more information about using discussions, see :ref:`Running_discussions`.
+For more information about using discussions, see :ref:`Best Practices for Configuring Course Discussions`.
 
 .. seealso::
 

source/educators/references/course_development/about_course_wiki.rst → source/educators/concepts/communication/about_course_wiki.rst

@@ -3,7 +3,7 @@
 About the Course Wiki
 ######################
 
-.. tags:: educator, reference
+.. tags:: educator, concept
 
 Courses can optionally configure a wiki application and set it up for appropriate use in your course.
 If you have specific expectations for how the wiki should be
@@ -78,9 +78,9 @@ the permissions that you set for an article.
 .. seealso::
 
 
- :ref:`Course Wiki Tasks <Course Wiki Tasks>` (how to)
+ :ref:`Manage the Course Wiki` (how to)
 
- :ref:`Using the Course Wiki <Create Course Wiki>` (how to)
+ :ref:`Contribute to the Course Wiki` (how to)
 
 
 **Maintenance chart**

source/educators/concepts/communication/about_divided_discussions.rst

@@ -1,6 +1,6 @@
 .. _About Divided Discussions:
 
-About Divided Discussion Topics
+About Divided Discussions
 ###################################
 
 .. tags:: educator, concept
@@ -12,11 +12,13 @@ divided by learner groups (cohorts) within your course.
   :local:
   :depth: 1
 
-For overview information about discussions in a course, see :ref:`Discussions`.
+For overview information about discussions in a course, see :ref:`About Course Discussions`.
 
 For more information about creating differentiated course content for learners
 in different groups (cohorts), see :ref:`Offering Differentiated Content`.
 
+For information about Setting Up Divided Discussions, see :ref:`Set Up Divided Discussions`.
+
 
 What Are Divided Discussions?
 ******************************
@@ -45,10 +47,9 @@ Community TAs if the content of discussion topics by one group (cohort) should n
 shared with another group. Group Community TAs are themselves members of
 learner groups (cohorts) that you use in your course. As discussion moderators, they can
 only see and respond to posts by other members of their own group (cohort). For information,
-see :ref:`Assigning_discussion_roles`.
+see :ref:`Assign discussion roles`.
 
-For more information about managing discussions, see :ref:`Managing Divided
-Discussion Topics` and :ref:`Running_discussions`.
+For more information about managing discussions, see :ref:`Guide to Managing Divided Discussions` and :ref:`Best Practices for Configuring Course Discussions`.
 
 .. note::
 
@@ -58,12 +59,33 @@ Discussion Topics` and :ref:`Running_discussions`.
   each component's access settings to restrict access to each discussion
   component to a specific content group. You can then assign these content
   groups to learner groups (cohorts). For more information,
-  see :ref:`Setting Up Divided Discussions`.
+  see :ref:`Set Up Divided Discussions`.
 
 .. seealso::
-
 
- :ref:`Setting Up Divided Discussions` (how-to)
+  :ref:`About Course Discussions` (concept)
+
+  :ref:`Best Practices for Configuring Course Discussions` (concept)
+
+  :ref:`Configure Open edX Discussions` (how-to)
+
+  :ref:`Configure Open edX Discussions Legacy` (how-to)
+
+  :ref:`Best Practices for Moderating Course Discussions` (concept)
+
+  :ref:`Assign discussion roles` (how-to)
+
+  :ref:`Moderate Discussions` (how-to)
+
+  :ref:`Toggle Anonymous Discussion Posts` (how-to)
+
+  :ref:`Learner View of the Discussion` (reference)
+
+  :ref:`Guide to Managing Divided Discussions` (reference)
+
+  :ref:`Set Up Divided Discussions` (how-to)
+
+  :ref:`Set up Discussions in Cohorted Courses` (how-to)
 
 
 

source/educators/concepts/communication/running_discussions.rst → source/educators/concepts/communication/best_practices_configuring_discussions.rst

@@ -1,18 +1,19 @@
-.. _Running_discussions:
+.. _Best Practices for Configuring Course Discussions:
 
-Running Course Discussions
-############################
+########################################################
+Best Practices for Configuring Course Discussions
+########################################################
 
 .. tags:: educator, concept
 
 On an ongoing basis, the members of your :ref:`discussion
-team<Assigning_discussion_roles>` run the course discussion by adding posts
+team<Assign discussion roles>` run the course discussion by adding posts
 and responses, marking answers as correct, and guiding learner messages into
 pertinent threads. The information and suggested techniques in this section
-can help you to make discussions in your course successful.
+can help you to configure successful discussions in your course.
 
 For information about moderating discussions, see
-:ref:`Moderating_discussions` and :ref:`Guidance for Discussion Moderators`.
+:ref:`Best Practices for Moderating Course Discussions`.
 
 .. contents::
  :local:
@@ -156,7 +157,7 @@ discussion.
   an existing post, or commenting on a response.
 
 
-.. _Close_discussions:
+.. _Closing discussions:
 
 ********************
 Closing Discussions
@@ -187,14 +188,30 @@ units and all course-wide topics are affected.
   can continue to add to discussions.
 
 .. seealso::
-
 
- :ref:`Discussions` (concept)
+  :ref:`About Course Discussions` (concept)
 
- :ref:`Configuring Open edX Discussions` (how-to)
+  :ref:`Configure Open edX Discussions` (how-to)
 
- :ref:`Closing Discussions` (how-to)
+  :ref:`Configure Open edX Discussions Legacy` (how-to)
 
+  :ref:`Best Practices for Moderating Course Discussions` (concept)
+
+  :ref:`Assign discussion roles` (how-to)
+
+  :ref:`Moderate Discussions` (how-to)
+
+  :ref:`Toggle Anonymous Discussion Posts` (how-to)
+
+  :ref:`Learner View of the Discussion` (reference)
+
+  :ref:`About Divided Discussions` (concept)
+
+  :ref:`Guide to Managing Divided Discussions` (reference)
+
+  :ref:`Set Up Divided Discussions` (how-to)
+
+  :ref:`Set up Discussions in Cohorted Courses` (how-to)
 
 **Maintenance chart**