From d6201e69d0a3bff5a1e7bf54dcbdcbd8140c5c32 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Sat, 11 Jan 2025 21:47:39 -0500 Subject: [PATCH 01/11] FC-0068 docs: concepts review by edunext 15 This PR modifies a series of concept documents migrated from the legacy repositories to the educators' documentation. --- .../about_divided_discussions.rst | 2 -- .../communication/course_discussions.rst | 25 +++++++++---------- .../discussion_guidance_moderators.rst | 14 ++++------- .../manage_divided_discussions.rst | 20 ++++++++------- .../communication/moderating_discussions.rst | 22 ++++++---------- .../communication/running_discussions.rst | 14 +++-------- .../open_edx_platform/outline_studio_lms.rst | 23 +++++++++++------ .../what_is_course_dashboard.rst | 15 ++++++----- .../open_edx_platform/what_is_lms.rst | 17 ++++++++----- .../what_is_profile_page.rst | 18 +++++++------ .../what_is_programs_page.rst | 20 ++++++++++++--- .../open_edx_platform/what_is_studio.rst | 22 +++++++++++++--- .../communication/configure-discussions.rst | 21 ++++++++-------- 13 files changed, 128 insertions(+), 105 deletions(-) diff --git a/source/educators/concepts/communication/about_divided_discussions.rst b/source/educators/concepts/communication/about_divided_discussions.rst index 3e4e7aa7f..bf73089d3 100644 --- a/source/educators/concepts/communication/about_divided_discussions.rst +++ b/source/educators/concepts/communication/about_divided_discussions.rst @@ -1,6 +1,5 @@ .. _About Divided Discussions: -################################### About Divided Discussion Topics ################################### @@ -19,7 +18,6 @@ For more information about creating differentiated course content for learners in different groups (cohorts), see :ref:`Offering Differentiated Content`. -****************************** What Are Divided Discussions? ****************************** diff --git a/source/educators/concepts/communication/course_discussions.rst b/source/educators/concepts/communication/course_discussions.rst index 3aa8d4ca3..9e66ec241 100644 --- a/source/educators/concepts/communication/course_discussions.rst +++ b/source/educators/concepts/communication/course_discussions.rst @@ -5,7 +5,7 @@ About Course Discussions .. tags:: educator, concept -Discussions in an edX course include both course-wide topics of interest to +Discussions in an Open edX course include both course-wide topics of interest to all learners (such as "Feedback", "Troubleshooting", or "Technical Help") as well as content-specific topics that you add to course units as discussion components. You can create both types of discussion topics in Studio. @@ -31,13 +31,13 @@ the course has started and the unit is released. However, "seed" posts that you create in content-specific discussion topics before a course starts, or before the unit is released, are immediately visible on the Discussion page, even though the containing category or subcategory -names are not visible. EdX recommends that you do not create posts in +names are not visible. The recommendation is that you do not create posts in content-specific discussion topics before a unit is released. For more information about release dates and the visibility of components, see :ref:`Controlling Content Visibility`. In contrast, :ref:`course-wide discussion topics` that you create on the edx discussions configuration page in Studio, +Topics>` that you create on the course discussions configuration page in Studio, including the default "General" discussion topic, are immediately visible, regardless of whether the course has started. They are not associated with any particular section or subsection of the course, and are not subject to @@ -45,16 +45,16 @@ release dates. .. _Discussions on Mobile Apps: -Discussions in the edX Mobile App -********************************* +Discussions in the Open edX Mobile App +*************************************** -Learners can participate in course discussions using the edX mobile app as -they do on the edX site, but there are some differences in the actions that +Learners can participate in course discussions using the Open edX mobile app of your instance as +they do on the website, but there are some differences in the actions that moderators can take in discussions using the mobile app. To perform moderation or administrative tasks for your course discussions, you need to work in a web browser. -The following actions are not supported on the edX mobile apps. +The following actions are not supported on the Open edX mobile apps. * Pinning posts * Marking responses to question posts as answers @@ -63,20 +63,19 @@ The following actions are not supported on the edX mobile apps. .. _The Upgraded Discussion Forum: -***************************************** The Upgraded Discussion Forum ***************************************** Course runs created on or after May 16, 2023, use an upgraded version of -the edX discussion forum. Learn more about it `here`_. +the Open edX discussion forum. Learn more about it `here`_. .. _here: https://openedx.atlassian.net/wiki/spaces/COMM/pages/3470655498/Discussions+upgrade+Sidebar+and+new+topic+structure. .. _Content Specific Discussion Topics: -============================================ + Content-specific Discussion Topics (Legacy) -============================================ +******************************************** To create a content-specific discussion topic, you add a discussion component to a unit. Typically, you do this while you are designing and creating your @@ -104,4 +103,4 @@ topics, see :ref:`Visibility of Discussion Topics`. .. seealso:: :class: dropdown - :ref:`Configuring Edx Discussions` (how-to) + :ref:`Configuring Open edX Discussions` (how-to) diff --git a/source/educators/concepts/communication/discussion_guidance_moderators.rst b/source/educators/concepts/communication/discussion_guidance_moderators.rst index fa8e04112..7abe28b58 100644 --- a/source/educators/concepts/communication/discussion_guidance_moderators.rst +++ b/source/educators/concepts/communication/discussion_guidance_moderators.rst @@ -1,6 +1,5 @@ .. _Guidance for Discussion Moderators: -###################################### Guidance for Discussion Moderators ###################################### @@ -24,7 +23,6 @@ contributions of your discussion moderators. :local: :depth: 1 -********************** Responsibilities ********************** @@ -50,7 +48,6 @@ Responsibilities * Add helpful items to the FAQ or to a welcome message or course handout. -*************************************** Qualities of Good Discussion Moderators *************************************** @@ -67,7 +64,7 @@ Qualities of Good Discussion Moderators * Enthusiasm: this is the best predictor of moderator excellence! -****************************************** + Best Practices for Discussion Moderation ****************************************** @@ -89,7 +86,7 @@ Best Practices for Discussion Moderation * Develop a discussion persona. Try to answer your questions in your own slightly unique way. -******************************************* + Guidelines for Specific Types of Posts ******************************************* @@ -154,21 +151,20 @@ Bugs or Errors platform. You might say: “Thanks for letting us know about that issue. We - are working with edX to get it fixed as quickly as possible.” + are working to get it fixed as quickly as possible.” ============================ Feature Requests ============================ * Keep an organized collection of feature requests cultivated by the course - team. That list can subsequently be shared with an edX product manager, who + team. That list can subsequently be shared with a product manager, who will log those requests internally. * Reply to the post to let the person know that their request was heard, without promising that the feature will be implemented. - You might say: "Thanks for your suggestion. I've logged it for review by edX - staff, who will prioritize feature requests on the development roadmap." + You might say: "Thanks for your suggestion. I've logged it for review by the Open edX Community, who will prioritize feature requests on the development roadmap." * Search the discussions for other similar requests, and respond to and close those as well. diff --git a/source/educators/concepts/communication/manage_divided_discussions.rst b/source/educators/concepts/communication/manage_divided_discussions.rst index 9253a3196..bb86043af 100644 --- a/source/educators/concepts/communication/manage_divided_discussions.rst +++ b/source/educators/concepts/communication/manage_divided_discussions.rst @@ -1,6 +1,5 @@ .. _Managing Divided Discussion Topics: -################################### Managing Divided Discussion Topics ################################### @@ -21,7 +20,6 @@ Discussions`. :local: :depth: 1 -********* Overview ********* @@ -31,11 +29,6 @@ particular group. For learners, this is the only noticeable difference between discussions in courses that use divided discussions, and courses that do not have groups and do not use divided discussions. -You can share the examples in the :ref:`Read the Group Indicator in Posts` -section with your learners. The `course discussions index`_ -section in the *Open edX Learner's Guide* also provides useful information to -help learners make the most of their participation in course discussions. - Course team members who have the Discussion Admin, Discussion Moderator, Community TA or Group Community TA role see the indicator of who can read each post. Team members with these roles, except for Group Community TAs, can read @@ -145,7 +138,7 @@ Community TA role can make posts to divided discussion topics visible to everyone who is enrolled in the course or only to the members of a specified group. -If you are a course team member with one of these roles, when you `add a post`_, the **Visible to** dropdown list appears above the **Title** +If you are a course team member with one of these roles, when you add a post, the **Visible to** dropdown list appears above the **Title** field. .. note:: Group Community TAs cannot choose the group visibility of a post. @@ -228,4 +221,13 @@ you filter the list by a specific group, you see the same, complete set of posts that the members of that group see. For other options that you can use to view posts, see -:ref:`Moderating_discussions`. \ No newline at end of file +:ref:`Moderating_discussions`. + +.. seealso:: + :class: dropdown + + :ref:`Guidance for Discussion Moderators` (concept) + + :ref:`Assigning_discussion_roles` (how-to) + + :ref:`Administer Discussions` (how-to) \ No newline at end of file diff --git a/source/educators/concepts/communication/moderating_discussions.rst b/source/educators/concepts/communication/moderating_discussions.rst index 66ca49d5b..7d4062106 100644 --- a/source/educators/concepts/communication/moderating_discussions.rst +++ b/source/educators/concepts/communication/moderating_discussions.rst @@ -1,6 +1,5 @@ .. _Moderating_discussions: -####################### Moderating Discussions ####################### @@ -25,8 +24,8 @@ relay it back to the course team. about discussion roles, see :ref:`About_discussion_roles`. .. note:: Not all options for moderating discussions are available when - discussions are accessed using the edX mobile apps. For information about - the differences between discussions on the edx.org site and in the mobile + discussions are accessed using the Open edX mobile app. For information about + the differences between discussions on the openedx.org site and in the mobile apps, see :ref:`Discussions on Mobile Apps`. .. contents:: @@ -34,14 +33,12 @@ relay it back to the course team. :depth: 1 For information about best practices for moderating discussions, see -:ref:`Guidance for Discussion Moderators`. If you are using :ref:`divided -discussions``, see :ref:`Managing Divided Discussion +:ref:`Guidance for Discussion Moderators`. If you are using `divided discussions `_, see :ref:`Managing Divided Discussion Topics`. .. _About_discussion_roles: -********************************* About Discussion Moderation Roles ********************************* @@ -59,7 +56,6 @@ moderate discussions and work with posts, responses, and comments. Admin role can grant discussion roles. -============================ The Discussion Roles ============================ @@ -68,9 +64,9 @@ the following roles. .. note:: The options for moderating discussions described below are only available when members of the discussion administration team work in a web - browser. The edX mobile apps do not currently offer moderation options. + browser. The Open edX mobile apps do not currently offer moderation options. - For more information about differences between discussions on the edx.org + For more information about differences between discussions on the openedx.org site and on the mobile apps, see :ref:`Discussions on Mobile Apps`. * Course team members with the Discussion Moderator role can edit and delete @@ -114,17 +110,13 @@ Provide Guidelines for Learners You can develop a set of best practices for discussion participation and make them available to learners 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. +introduce features of Open edX discussions. You can also refer learners to the `course discussions index`_ section in the *Open EdX Learner's Guide*. Consider referring learners in your courses to that section, which describes the structure and features of -edX course discussions, and provides useful information to help learners make +Open edX course discussions, and provides useful information to help learners make the most of their participation in course discussions. -.. For a template that you can use to develop your own guidelines, see -.. :ref:`Discussion Forum Guidelines`. - - .. _Develop a Positive Discussion Culture: *************************************** diff --git a/source/educators/concepts/communication/running_discussions.rst b/source/educators/concepts/communication/running_discussions.rst index 8d0f1f0ca..19499e531 100644 --- a/source/educators/concepts/communication/running_discussions.rst +++ b/source/educators/concepts/communication/running_discussions.rst @@ -1,6 +1,5 @@ .. _Running_discussions: -############################ Running Course Discussions ############################ @@ -46,13 +45,6 @@ The dialog created by a post, its responses, and the comments on those responses is sometimes called a thread. Discussion threads are saved as part of the course history. -For information about participating in discussions, see the -`course discussions index`_ section in the *Open edX -Learner's Guide*. Consider referring learners in your courses to that section, -which describes the structure and features of course discussions, and provides -useful information to help learners make the most of their participation in -course discussions. - ************************************************ Using Naming Conventions for Discussion Topics @@ -100,7 +92,7 @@ Some examples follow. providing guidance, these initial messages can act as models for learners to follow when they create their own posts. -EdX strongly recommends that you do not create seed posts in content-specific +It is strongly recommended that you do not create seed posts in content-specific discussion topics before the course starts or before the containing unit is released. The category and subcategory names for content-specific discussion topics are subject to the release visibility of their containing unit, and are @@ -120,7 +112,7 @@ discussion. .. note:: You can only pin or close posts and mark questions as answered when you work in a web browser. You cannot complete these activities when you - work in the edX mobile app. + work in the Open edX mobile app. * Pin posts. Pinning a post makes it appear at the top of the list of posts in the discussion navigation pane on the **Discussion** page. As a result, it is @@ -199,6 +191,6 @@ units and all course-wide topics are affected. :ref:`Discussions` (concept) - :ref:`Configuring Edx Discussions` (how-to) + :ref:`Configuring Open edX Discussions` (how-to) :ref:`Closing Discussions` (how-to) diff --git a/source/educators/concepts/open_edx_platform/outline_studio_lms.rst b/source/educators/concepts/open_edx_platform/outline_studio_lms.rst index 6ccda0734..9b1430f29 100644 --- a/source/educators/concepts/open_edx_platform/outline_studio_lms.rst +++ b/source/educators/concepts/open_edx_platform/outline_studio_lms.rst @@ -1,8 +1,7 @@ .. _Course Outline: -================== Course Outline -================== +############## .. tags:: educator, concept @@ -21,13 +20,13 @@ The numbers represent the following levels. #. :ref:`Units` .. note:: - The **Course Outline** page does not show :ref:`components`. You add or access components by selecting the units + The **Course Outline** page does not show :ref:`components`. You add or access components by selecting the units that contain the components. -=========================== + Course Progress Information -=========================== +**************************** The course outline in the LMS also indicates a learner's progress through the course. A green check mark next to the name of a section, subsection, or unit @@ -42,5 +41,13 @@ If a learner selects the **Resume Course** option, the course opens to the unit that the learner most recently completed. For information about more specific learner data, including the learner's -grades or answers for individual problems, see :ref:`Manage Student Progress -Index`. \ No newline at end of file +grades or answers for individual problems, see :ref:`Nav Learner Data`. + +.. seealso:: + :class: dropdown + + :ref:`Understanding a Course Outline ` (reference) + + :ref:`Add Content in the Course Outline` (reference) + + :ref:`Developing Your Course Outline` (reference) \ No newline at end of file diff --git a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst index f40b9dd97..d394e6bc9 100644 --- a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst +++ b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst @@ -1,6 +1,7 @@ -****************************************** +.. _What is Course Dashboard: + What is the Course Dashboard? -****************************************** +############################# .. tags:: educator, concept @@ -22,18 +23,16 @@ icon next to your username at the top of any page. You can find information about your courses and change course-specific email subscription settings on your dashboard. For more information, see :doc:`update_course_specific_settings <../../how-tos/update_course_specific_settings>`. -.. only:: Partners - The dashboard has three main pages. * The **Courses** page provides information about your courses and allows you to change course settings. By default, the dashboard opens to the **Courses** page. The **Courses** page on the dashboard now includes two main categories of filters with subcategories in each main category. **Course Status** includes 'In progress,' 'Not Started,' 'Done,' 'Not Enrolled,' and 'Upgraded.' These different filters allow you to filter all of the courses based on the course status. **Sort** includes 'Last enrolled' and 'Title (A-Z).' These filters allow you to filter the course alphabetically or when you were last enrolled in the course. -* The **Programs** page lists any programs, such as XSeries or MicroMasters programs, that edX offers for courses that you are enrolled in. Programs appear on this page if you are enrolled in any course that is part of that program. This page also shows how many courses in the program you have completed, how many are in progres, and the number of remaining courses you have left in the program. For more information, see :ref:`Explore edX Programs `. - -* The **Discover New** page take you to `the edX website `_ and will allow you to search for any courses on the edX platform that interest you. +* The **Programs** page lists any programs offer by your Open edX instance for courses that you are enrolled in. Programs appear on this page if you are enrolled in any course that is part of that program. This page also shows how many courses in the program you have completed, how many are in progres, and the number of remaining courses you have left in the program. . .. seealso:: :class: dropdown - :doc:`share_courses_social_media <../../how-tos/share_courses_social_media>` (how-to) \ No newline at end of file + :doc:`Share Courses Social Media <../../how-tos/share_courses_social_media>` (how-to) + + :ref:`What is the User Profile Page` (concept) \ No newline at end of file diff --git a/source/educators/concepts/open_edx_platform/what_is_lms.rst b/source/educators/concepts/open_edx_platform/what_is_lms.rst index 8cb22eb2b..0d4a3b143 100644 --- a/source/educators/concepts/open_edx_platform/what_is_lms.rst +++ b/source/educators/concepts/open_edx_platform/what_is_lms.rst @@ -1,8 +1,7 @@ .. _What is LMS: -**************** What Is the LMS? -**************** +################# .. tags:: educator, concept @@ -15,10 +14,16 @@ If you have not created a course, see :ref:`Creating a New Course` (how-to) - :doc:`add_update_full_profile <../../how-tos/add_update_full_profile>` (how-to) - :doc:`add_links_to_social_media_accounts <../../how-tos/add_links_to_social_media_accounts>` (how-to) - :doc:`view_another_learners_profile <../../how-tos/view_another_learners_profile>` (how-to) \ No newline at end of file + :doc:`Add or Update a Limited Profile <../../how-tos/add_update_limited_profile>` (how-to) + + :doc:`Add or Update a Full Profile <../../how-tos/add_update_full_profile>` (how-to) + + :doc:`Add Links to Your Personal Social Media Accounts <../../how-tos/add_links_to_social_media_accounts>` (how-to) + + :doc:`View Another Learner’s Profile <../../how-tos/view_another_learners_profile>` (how-to) \ No newline at end of file diff --git a/source/educators/concepts/open_edx_platform/what_is_programs_page.rst b/source/educators/concepts/open_edx_platform/what_is_programs_page.rst index 6d4c8a64d..afeb667ec 100644 --- a/source/educators/concepts/open_edx_platform/what_is_programs_page.rst +++ b/source/educators/concepts/open_edx_platform/what_is_programs_page.rst @@ -1,6 +1,7 @@ -####################################### +.. _What is the Programs Page: + What is the Programs Page? -####################################### +############################# .. tags:: educator, concept @@ -28,4 +29,17 @@ On the **Programs** page, you can perform the following actions. In the right pane, a **Program Certificates** list shows the names of programs for which you have earned certificates. For more information about - the program, or to view the certificate, select the name of the program. \ No newline at end of file + the program, or to view the certificate, select the name of the program. + +.. seealso:: + :class: dropdown + + :ref:`What is Course Dashboard` (concept) + + :ref:`What is LMS` (concept) + + :ref:`What is Studio` (concept) + + :ref:`Course Outline` (concept) + + :ref:`What is the User Profile Page` (concept) \ No newline at end of file diff --git a/source/educators/concepts/open_edx_platform/what_is_studio.rst b/source/educators/concepts/open_edx_platform/what_is_studio.rst index f4f938044..c0dc4f8a9 100644 --- a/source/educators/concepts/open_edx_platform/what_is_studio.rst +++ b/source/educators/concepts/open_edx_platform/what_is_studio.rst @@ -1,8 +1,7 @@ .. _What is Studio: -*************** What Is Studio? -*************** +############### .. tags:: educator, concept @@ -15,4 +14,21 @@ With Studio, you can also manage the course schedule, identify members of the course team, set the grading policy, publish your course, and more. You use Studio directly through your browser. You do not need any additional -software. \ No newline at end of file +software. + +.. seealso:: + :class: dropdown + + :ref:`Getting Started with Course Content Development` (reference) + + :ref:`Course Outline` (concept) + + :ref:`Create a Course` (how-to) + + :ref:`Create the Course About Page` (how-to) + + :ref:`Understanding a Course Outline ` (reference) + + :ref:`Add Content in the Course Outline` (reference) + + :ref:`Developing Your Course Outline` (reference) diff --git a/source/educators/how-tos/communication/configure-discussions.rst b/source/educators/how-tos/communication/configure-discussions.rst index f13a0339d..a8504245a 100644 --- a/source/educators/how-tos/communication/configure-discussions.rst +++ b/source/educators/how-tos/communication/configure-discussions.rst @@ -1,4 +1,4 @@ -.. _Configuring Edx Discussions: +.. _Configuring Open edX Discussions: ################################ Configuring Open edX Discussions @@ -25,14 +25,14 @@ tile. Click Next. .. image:: /_images/educator_how_tos/Tile_for_edx_discussion_provider.png :width: 300 - :alt: Appearance of tile for edx discussion provider in configuration. + :alt: Appearance of tile for Open edx discussion provider in configuration. 5. This is the Open edX discussions configuration page. All configuration options for Open edX discussions can be found here. .. image:: /_images/educator_how_tos/edx_discussions_configurations_page.png :width: 300 - :alt: Appearance of edx discussions configurations page. + :alt: Appearance of Open edX discussions configurations page. .. _Create CourseWide Discussion Topics: @@ -103,7 +103,7 @@ the forum `. To enable discussion on a cours .. image:: /_images/educator_how_tos/enable-discussion.png :width: 700 :align: center - :alt: Toggle switches for anonymous posts in edx discussions configuration. + :alt: Toggle switches for anonymous posts in Open edX discussions configuration. 3. Click **Save**. @@ -113,11 +113,11 @@ discussions enabled for them will show a **Discussion enabled** label in Studio. .. image:: /_images/educator_how_tos/discussion-enabled.png :width: 700 :align: center - :alt: Toggle switches for anonymous posts in edx discussions configuration. + :alt: Toggle switches for anonymous posts in Open edX discussions configuration. .. note:: To enable discussion for units in subsections marked as graded (but not **Timed Exams**), first enable the **Enable discussions on units in graded - subsusections** toggle on discussion configuration page in studio (see :ref:`Configuring Edx Discussions`). + subsusections** toggle on discussion configuration page in studio (see :ref:`Configuring Open edX Discussions`). .. note:: Discussions can not be enabled for units belonging to subsections marked as **Timed Exams**. @@ -128,8 +128,7 @@ discussion sidebar visible alongside the course unit. .. image:: /_images/educator_how_tos/discussion-sidebar.png :width: 300 :align: center - :alt: Toggle switches for anonymous posts in edx discussions configuration. - + :alt: Toggle switches for anonymous posts in Open edX discussions configuration. To disable discussion for a unit, uncheck the **Discussion enabled** checkbox in the unit’s configuration and click **Save**. @@ -143,10 +142,10 @@ with the threads contained within it. .. image:: /_images/educator_how_tos/archived.png :width: 300 :height: 400 - :alt: Toggle switches for anonymous posts in edx discussions configuration. + :alt: Toggle switches for anonymous posts in Open edX discussions configuration. .. warning:: If **Enable discussions on units in graded subsections** toggle on - the discussion configuration page (see :ref:`Configuring Edx Discussions`) is turned + the discussion configuration page (see :ref:`Configuring Open edX Discussions`) is turned off, any discussion topics associated with units belonging to graded subsections will be archived or deleted (if they don’t contain any threads). Enabling the toggle again will restore archived topics and replace deleted topics with new ones. @@ -170,7 +169,7 @@ to other learners. To allow anonymous discussion posts in your course, follow these steps. 1. Navigate to Open edX discussion configuration page -(see :ref:`Configuring Edx Discussions`). +(see :ref:`Configuring Open edX Discussions`). 2. Toggle the **Allow anonymous discussion posts to peers** to enable learners to make posts that are anonymous to everyone other learners. From 8c72a76be528396ae14f7e1961a8d1374b315d60 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Sat, 11 Jan 2025 21:58:13 -0500 Subject: [PATCH 02/11] Update configure-discussions.rst --- .../how-tos/communication/configure-discussions.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/source/educators/how-tos/communication/configure-discussions.rst b/source/educators/how-tos/communication/configure-discussions.rst index a8504245a..cb4a81130 100644 --- a/source/educators/how-tos/communication/configure-discussions.rst +++ b/source/educators/how-tos/communication/configure-discussions.rst @@ -6,21 +6,21 @@ Configuring Open edX Discussions .. tags:: educator, how-to -For opening Open edX discussions configuration page, follow these steps. +To open the Open edX discussions configuration page, follow these steps. 1. Open your course in Studio. 2. Select **Content**, then **Pages & Resources**. -3. Click on the gear icon on top-right of **Discussion** tile (as seen below). -This will take you to the discussions configuration page where you can select +3. Click on the gear icon on the top-right of the **Discussion** tile (as seen below). +This will take you to the discussions configuration page, where you can select a discussion provider. .. image:: /_images/educator_how_tos/Discussion_tile_in_pages_and_resources.png :width: 300 :alt: Appearance of Discussion tile in Pages & Resources. -4. Select Open edX as discussion provider by checking the box on top-right of **Open edX** +4. Select Open edX as the discussion provider by checking the box on the top-right of **Open edX** tile. Click Next. .. image:: /_images/educator_how_tos/Tile_for_edx_discussion_provider.png @@ -129,6 +129,7 @@ discussion sidebar visible alongside the course unit. :width: 300 :align: center :alt: Toggle switches for anonymous posts in Open edX discussions configuration. + To disable discussion for a unit, uncheck the **Discussion enabled** checkbox in the unit’s configuration and click **Save**. @@ -193,4 +194,4 @@ that are anonymous to other learners, as seen below. :ref:`Discussions` (concept) - \ No newline at end of file + From 2df20e35d8dddcfb9b8fee0c4902189a887fc6e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:22:33 -0500 Subject: [PATCH 03/11] Update source/educators/concepts/communication/discussion_guidance_moderators.rst Co-authored-by: Sarina Canelake --- .../concepts/communication/discussion_guidance_moderators.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/communication/discussion_guidance_moderators.rst b/source/educators/concepts/communication/discussion_guidance_moderators.rst index 7abe28b58..ed1b58d66 100644 --- a/source/educators/concepts/communication/discussion_guidance_moderators.rst +++ b/source/educators/concepts/communication/discussion_guidance_moderators.rst @@ -157,7 +157,7 @@ Bugs or Errors Feature Requests ============================ -* Keep an organized collection of feature requests cultivated by the course +* Consider keeping an organized collection of feature requests cultivated by the course team, to share with the Open edX community for potential future feature development. team. That list can subsequently be shared with a product manager, who will log those requests internally. From 904a45e8789461474d34fe61daaa35ae65b83266 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:22:55 -0500 Subject: [PATCH 04/11] Update source/educators/concepts/communication/moderating_discussions.rst Co-authored-by: Sarina Canelake --- .../educators/concepts/communication/moderating_discussions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/communication/moderating_discussions.rst b/source/educators/concepts/communication/moderating_discussions.rst index 7d4062106..192bbb26f 100644 --- a/source/educators/concepts/communication/moderating_discussions.rst +++ b/source/educators/concepts/communication/moderating_discussions.rst @@ -25,7 +25,7 @@ relay it back to the course team. .. note:: Not all options for moderating discussions are available when discussions are accessed using the Open edX mobile app. For information about - the differences between discussions on the openedx.org site and in the mobile + the differences between discussions on the desktop site and in the mobile apps, see :ref:`Discussions on Mobile Apps`. .. contents:: From c3227a96785afd96d069592b42b90280837830ad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:23:05 -0500 Subject: [PATCH 05/11] Update source/educators/concepts/communication/moderating_discussions.rst Co-authored-by: Sarina Canelake --- .../educators/concepts/communication/moderating_discussions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/communication/moderating_discussions.rst b/source/educators/concepts/communication/moderating_discussions.rst index 192bbb26f..0dc092bd3 100644 --- a/source/educators/concepts/communication/moderating_discussions.rst +++ b/source/educators/concepts/communication/moderating_discussions.rst @@ -66,7 +66,7 @@ the following roles. available when members of the discussion administration team work in a web browser. The Open edX mobile apps do not currently offer moderation options. - For more information about differences between discussions on the openedx.org + For more information about differences between discussions on the desktop site and on the mobile apps, see :ref:`Discussions on Mobile Apps`. * Course team members with the Discussion Moderator role can edit and delete From 79284ec524de504d69c7b0c577b1fe4cc9c3c673 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:23:25 -0500 Subject: [PATCH 06/11] Update source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst Co-authored-by: Sarina Canelake --- .../concepts/open_edx_platform/what_is_course_dashboard.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst index d394e6bc9..f9e1ffe75 100644 --- a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst +++ b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst @@ -23,7 +23,7 @@ icon next to your username at the top of any page. You can find information about your courses and change course-specific email subscription settings on your dashboard. For more information, see :doc:`update_course_specific_settings <../../how-tos/update_course_specific_settings>`. -The dashboard has three main pages. +The dashboard has two main pages. * The **Courses** page provides information about your courses and allows you to change course settings. By default, the dashboard opens to the **Courses** page. The **Courses** page on the dashboard now includes two main categories of filters with subcategories in each main category. **Course Status** includes 'In progress,' 'Not Started,' 'Done,' 'Not Enrolled,' and 'Upgraded.' These different filters allow you to filter all of the courses based on the course status. **Sort** includes 'Last enrolled' and 'Title (A-Z).' These filters allow you to filter the course alphabetically or when you were last enrolled in the course. From c332643e551d74239c6e654d7b5730817c83633c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:23:41 -0500 Subject: [PATCH 07/11] Update source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst Co-authored-by: Sarina Canelake --- .../concepts/open_edx_platform/what_is_course_dashboard.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst index f9e1ffe75..309ee515e 100644 --- a/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst +++ b/source/educators/concepts/open_edx_platform/what_is_course_dashboard.rst @@ -28,7 +28,7 @@ The dashboard has two main pages. * The **Courses** page provides information about your courses and allows you to change course settings. By default, the dashboard opens to the **Courses** page. The **Courses** page on the dashboard now includes two main categories of filters with subcategories in each main category. **Course Status** includes 'In progress,' 'Not Started,' 'Done,' 'Not Enrolled,' and 'Upgraded.' These different filters allow you to filter all of the courses based on the course status. **Sort** includes 'Last enrolled' and 'Title (A-Z).' These filters allow you to filter the course alphabetically or when you were last enrolled in the course. -* The **Programs** page lists any programs offer by your Open edX instance for courses that you are enrolled in. Programs appear on this page if you are enrolled in any course that is part of that program. This page also shows how many courses in the program you have completed, how many are in progres, and the number of remaining courses you have left in the program. . +* The **Programs** page lists any programs offer by your Open edX instance for courses that you are enrolled in. Programs appear on this page if you are enrolled in any course that is part of that program. This page also shows how many courses in the program you have completed, how many are in progres, and the number of remaining courses you have left in the program. .. seealso:: :class: dropdown From 3904269390b716b6179b842c0507d4bab4bcdf58 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:23:52 -0500 Subject: [PATCH 08/11] Update source/educators/concepts/open_edx_platform/what_is_profile_page.rst Co-authored-by: Sarina Canelake --- .../concepts/open_edx_platform/what_is_profile_page.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/concepts/open_edx_platform/what_is_profile_page.rst b/source/educators/concepts/open_edx_platform/what_is_profile_page.rst index 82a1ea130..61ebbdc49 100644 --- a/source/educators/concepts/open_edx_platform/what_is_profile_page.rst +++ b/source/educators/concepts/open_edx_platform/what_is_profile_page.rst @@ -27,7 +27,7 @@ You can share either a limited profile or a full profile. * Your full name * Your username * Your profile image (optional) - * The date that you joined to the Open edX instance. + * The date that you joined the Open edX instance. * Your language (optional) * Your location (optional) * Information about you (optional) From 6e68199c5459b4193cfbb5007704686b22649274 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:24:06 -0500 Subject: [PATCH 09/11] Update source/educators/how-tos/communication/configure-discussions.rst Co-authored-by: Sarina Canelake --- .../educators/how-tos/communication/configure-discussions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/how-tos/communication/configure-discussions.rst b/source/educators/how-tos/communication/configure-discussions.rst index cb4a81130..3a1f960cc 100644 --- a/source/educators/how-tos/communication/configure-discussions.rst +++ b/source/educators/how-tos/communication/configure-discussions.rst @@ -25,7 +25,7 @@ tile. Click Next. .. image:: /_images/educator_how_tos/Tile_for_edx_discussion_provider.png :width: 300 - :alt: Appearance of tile for Open edx discussion provider in configuration. + :alt: Appearance of tile for Open edX discussion provider in configuration. 5. This is the Open edX discussions configuration page. All configuration options for Open edX discussions can be found here. From 27e48dc1b34a8119c64da7dc58a6e087967d44d6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ana=20Paula=20G=C3=B3mez?= <131492787+Apgomeznext@users.noreply.github.com> Date: Tue, 14 Jan 2025 13:47:40 -0500 Subject: [PATCH 10/11] commit errors --- .../educators/how-tos/communication/closing_discussions.rst | 2 +- .../educators/how-tos/communication/configure-discussions.rst | 2 +- .../how-tos/communication/setting_up_divided_discussions.rst | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/educators/how-tos/communication/closing_discussions.rst b/source/educators/how-tos/communication/closing_discussions.rst index 31dbed552..55ae7f03d 100644 --- a/source/educators/how-tos/communication/closing_discussions.rst +++ b/source/educators/how-tos/communication/closing_discussions.rst @@ -42,4 +42,4 @@ reopen, follow these steps. :ref:`Running_discussions` (concept) - :ref:`Configuring Edx Discussions` (how-to) \ No newline at end of file + :ref:`Configuring Open edX Discussions` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/communication/configure-discussions.rst b/source/educators/how-tos/communication/configure-discussions.rst index 7071ed182..470d76060 100644 --- a/source/educators/how-tos/communication/configure-discussions.rst +++ b/source/educators/how-tos/communication/configure-discussions.rst @@ -58,7 +58,7 @@ Discussions in these topics can begin as soon as your course is available. To create a course-wide discussion topic, follow these steps. -1. Navigate to Open edX discussion provider configuration page (see :ref:`Configuring Edx Discussions`). +1. Navigate to Open edX discussion provider configuration page (see :ref:`Configuring Open edX Discussions`). 2. Scroll down to **General discussion topics**. You would see a topic named **General** already there. This topic cannot be deleted but can be renamed. diff --git a/source/educators/how-tos/communication/setting_up_divided_discussions.rst b/source/educators/how-tos/communication/setting_up_divided_discussions.rst index c496718f6..9e1e9a2ec 100644 --- a/source/educators/how-tos/communication/setting_up_divided_discussions.rst +++ b/source/educators/how-tos/communication/setting_up_divided_discussions.rst @@ -49,7 +49,7 @@ the steps below. course, be aware that learners will be affected by your changes. 1. Navigate to Open edX discussion provider configuration page -(see :ref:`Configuring Edx Discussions`). +(see :ref:`Configuring Open edX Discussions`). 2. Turn on the toggle for **Divide discussions by cohort** to divide all content-specific discussion topics by cohort. @@ -88,7 +88,7 @@ course can see and respond to posts from all other learners. To specify that one or more course-wide discussion topics are divided, follow these steps. -1. Navigate to Open edx discussion provider configuration page (see :ref:`Configuring Edx Discussions`). +1. Navigate to Open edx discussion provider configuration page (see :ref:`Configuring Open edX Discussions`). 2. Turn on the toggle for **Divide discussions by cohort** to divide all content-specific discussion topics by cohort. From 209dcbb8b8791a3c6c4b85198179c41bd8773186 Mon Sep 17 00:00:00 2001 From: Sarina Canelake Date: Tue, 14 Jan 2025 17:05:52 -0500 Subject: [PATCH 11/11] Apply suggestions from code review --- .../concepts/communication/discussion_guidance_moderators.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/educators/concepts/communication/discussion_guidance_moderators.rst b/source/educators/concepts/communication/discussion_guidance_moderators.rst index ed1b58d66..05dd3b11e 100644 --- a/source/educators/concepts/communication/discussion_guidance_moderators.rst +++ b/source/educators/concepts/communication/discussion_guidance_moderators.rst @@ -158,8 +158,6 @@ Feature Requests ============================ * Consider keeping an organized collection of feature requests cultivated by the course team, to share with the Open edX community for potential future feature development. - team. That list can subsequently be shared with a product manager, who - will log those requests internally. * Reply to the post to let the person know that their request was heard, without promising that the feature will be implemented.