Educators RST Fixes and Removal of Legacy references

* cleanup for howtos3 cleaning up drag_and_drop_deprecated.rst doc * cleaning up for adding_mathjax.rst * cleanup for adding_numerical_input_problem.rst * cleaning up for add_text_input.rst doc * cleaning up for library_access.rst * cleaning up for add_beta_testers.rst * cleaning up set_licensing.rst * adjusting and deleting edx ref * cleaning up for hide_subsections.rst * cleaning up for create_hide_delete_sections.rst * cleaning up for course_rerun.rst * cleaning up for update_rerun_course.rst * cleaning up for issuing_certificates.rst * cleaning up for view_course_information.rst * cleaning up for manage_course_enrollements.rst * cleaning up for manage_course_grades.rst * cleaning up for course_answers.rst * cleaning up for certificate_data.rst * cleanup for download_or_view_learner_data.rst * cleaning up for access_anonymized_data.rst * cleaning up for send_bulk_email.rst * cleaning up for review_sent_messages.rst * cleaning up for allow_anonymous_discussions.rst * cleaning up for administer_discussions.rst * adjusting reference * cleaning up setup_cohorted_discussions.rst * cleaning up for closing_discussions.rst * cleaning up for assigning_discussion_roles.rst * cleaning up for setting_up_divided_discussions.rst * fixing errors * adjustments asked by Sarina * Delete source/educators/how-tos/drag_and_drop_deprecated.rst * deleting edx references * fixing error_ToC * fixing error ToC deleting file * fixing error undeleting file * fixing error_tOC * fixing error ref * changing reference to fix error * export_course.rst * deleting ..only:: ref for update_rerun_course.rst * deleting master's courses ref for manage_course_grades.rst * adding space * adjusting headers * adjusting headers --------- Co-authored-by: Jesica Greco <[email protected]>
openedx · Dec 23, 2024 · 352ba91 · 352ba91
1 parent 9201589
commit 352ba91
Show file tree

Hide file tree

Showing 28 changed files with 192 additions and 915 deletions.
diff --git a/source/educators/how-tos/allow_anonymous_discussions.rst b/source/educators/how-tos/allow_anonymous_discussions.rst
@@ -1,3 +1,4 @@
+#########################################
 Enable/Disable Anonymous Discussion Posts
 #########################################
 
@@ -13,7 +14,7 @@ Generally, you'll choose one or none of the options based on your course policie
 
 	Note that an admin must be a "Discussion Admin" in order to view anonymous posts. This role is separate from a course staff or course admin.
 
-
+********************************
 Allow Anonymous Discussion Posts
 ********************************
 
@@ -33,7 +34,7 @@ A discussion staff's view of an anonymous post
 ..  image:: /_images/educator_how_tos/staff_view_anonymous.png
 	:alt: A screenshot of a staff member viewing an anonymous discussion forum message. They cannot see username.
 
-
+*****************************************
 Allow Anonymous Discussion Posts to Peers
 *****************************************
 
@@ -52,13 +53,13 @@ A discussion staff's view of an anonymous post to classmates:
 ..  image:: /_images/educator_how_tos/staff_view_anonymous_class.png
 	:alt: A screenshot of a staff member viewing an anonymous discussion forum message. They can see username.
 
-
+=================================================
 Enable/Disable "Allow Anonymous Discussion Posts"
 =================================================
 1. From your course Studio, navigate to *Advanced Settings*
 2. Set "Allow Anonymous Discussion Posts" to true/false to enable/disable.
 
-
+==========================================================
 Enable/Disable "Allow Anonymous Discussion Posts to Peers"
 ==========================================================
 1. From your course Studio, navigate to *Advanced Settings*

diff --git a/source/educators/how-tos/communication/administer_discussions.rst b/source/educators/how-tos/communication/administer_discussions.rst
@@ -1,24 +1,21 @@
 .. _Administer Discussions:
 
-##########################
+######################
 Administer Discussions
-##########################
+######################
 
 .. tags:: educator, how-to
 
-****************
+*************
 Edit Messages
-****************
+*************
 
 Team members with the Discussion Moderator, Discussion Admin, Community TA or
 Group Community TA role can edit the content of posts, responses, and
 comments. Messages that include spoilers or solutions, or that contain
 inappropriate or off-topic material, should be edited quickly to remove text,
 images, or links.
 
-.. removed note for open edx re edit behavior in mobile apps. Posts can
-.. now be edited in the mobile apps (though ability depends on permissions)
-.. CT April 25, 2016
 
 #. View the live version of the course.
 
@@ -35,18 +32,15 @@ images, or links.
 #. Communicate the reason for your change. For example, "Posting a solution
    violates the honor code."
 
-****************
+***************
 Delete Messages
-****************
+***************
 
 Team members with the Discussion Moderator, Discussion Admin, Community TA or
 Group Community TA role can delete posts, responses, or comments. It might be
 more appropriate to delete rather than edit posts that consist of spam or
 include abusive language.
 
-.. removed note for open edx re deletion behavior in mobile apps. Posts can
-.. now be deleted in the mobile apps (though ability depends on permissions)
-.. CT April 25, 2016
 
 #. View the live version of the course.
 
@@ -64,17 +58,15 @@ include abusive language.
  before taking any other action.
 
 
-********************************
+****************************
 Respond to Reports of Misuse
-********************************
+****************************
 
 Learners have the option to report contributions that they find inappropriate.
 Team members with the Discussion Moderator, Discussion Admin, Community TA or
 Group Community TA role can check for messages that have been flagged in this
 way and edit or delete them as needed.
 
-.. removed note for open edx re flag behavior in mobile apps. Posts can
-.. now be flagged in the mobile apps. CT April 25, 2016
 
 #. View the live version of your course and select **Discussion** at the top of
    the page.
@@ -90,12 +82,12 @@ way and edit or delete them as needed.
    flag: select the "More" icon and then **Unreport**.
 
 
-*****************************************************
+****************************************************
 View Profile Information for Discussion Participants
-*****************************************************
+****************************************************
 
 To find out more about a specific discussion participant, you can view that
-learner's edX profile from their linked username on discussion posts.
+learner's profile from their linked username on discussion posts.
 
 To access a learner's profile from a discussion post that they contributed,
 follow these steps.
@@ -108,12 +100,11 @@ follow these steps.
 The learner's account profile page opens. Learners can have either a limited
 profile or a full profile.
 
-For more information about profiles, see `SFD Dashboard <sfd dashboard>`_.
 
 
-****************
+***********
 Block Users
-****************
+***********
 
 If a learner repeatedly misuses course discussions despite being warned, you
 can unenroll that learner from the course. For more information, see

diff --git a/source/educators/how-tos/communication/assigning_discussion_roles.rst b/source/educators/how-tos/communication/assigning_discussion_roles.rst
@@ -1,8 +1,8 @@
 .. _Assigning_discussion_roles:
 
-*************************************
+#####################################
 Assigning Discussion Moderation Roles
-*************************************
+#####################################
 
 .. tags:: educator, how-to
 
@@ -25,9 +25,9 @@ add.
   downloaded file, locate the required email address or username.
 
 
-====================================
+********************************
 Add Someone To a Discussion Role
-====================================
+********************************
 
 You can add any user who is already enrolled in your course to a discussion
 moderation role.
@@ -51,9 +51,9 @@ moderation role.
    The person who you added appears in the list.
 
 
-======================================
+*************************************
 Remove Someone from a Discussion Role
-======================================
+*************************************
 
 To remove someone from a discussion moderation role, you must be the course
 author or have the Admin role.

diff --git a/source/educators/how-tos/communication/closing_discussions.rst b/source/educators/how-tos/communication/closing_discussions.rst
@@ -1,19 +1,18 @@
 .. _Closing Discussions:
 
-============================================
+###################
 Closing Discussions
-============================================
+###################
 
 .. tags:: educator, how-to
 
 .. note:: You can only close discussions when you work in a web browser. You
-   cannot close discussions when you work in an edX mobile app.
+   cannot close discussions when you work in an Open edX mobile app.
 
 To define when discussions are closed to new contributions and when they
 reopen, follow these steps.
 
-1. Navigate to edx discussion configuration page
-(see :ref:`Configuring Edx Discussions`).
+1. Navigate to Open edx discussion configuration page
 
 2. Scroll down to **Discussion Blackout Dates** field.
 

diff --git a/source/educators/how-tos/communication/review_sent_messages.rst b/source/educators/how-tos/communication/review_sent_messages.rst
@@ -1,8 +1,8 @@
 .. _Review Sent Messages:
 
-********************************
+####################
 Review Sent Messages
-********************************
+####################
 
 .. tags:: educator, how-to
 

diff --git a/source/educators/how-tos/communication/send_bulk_email.rst b/source/educators/how-tos/communication/send_bulk_email.rst
@@ -1,8 +1,8 @@
 .. _Send_Bulk_Email:
 
-**************************************************
+############################################
 Send an Email Message to Course Participants
-**************************************************
+############################################
 
 .. tags:: educator, how-to
 
@@ -40,9 +40,9 @@ while you wait for your message to be sent.
 
 .. _Send_Scheduled_Bulk_Email:
 
-*********************************************************
+*****************************************************
 Send a Scheduled Email Message to Course Participants
-*********************************************************
+*****************************************************
 
 We have introduced a way to schedule a bulk email message to be sent at a
 specified date and time in the future. Once a message has been scheduled,

diff --git a/source/educators/how-tos/communication/setting_up_divided_discussions.rst b/source/educators/how-tos/communication/setting_up_divided_discussions.rst
@@ -1,8 +1,8 @@
 .. _Setting Up Divided Discussions:
 
-******************************
+##############################
 Setting Up Divided Discussions
-******************************
+##############################
 
 .. tags:: educator, how-to
 
@@ -35,9 +35,9 @@ topics.
 
 .. _Divide All Content Specific Discussion Topics:
 
-**********************************************
+*********************************************
 Divide All Content-Specific Discussion Topics
-**********************************************
+*********************************************
 
 When you :ref:`create content-specific discussion topics<Create
 ContentSpecific Discussion Topics>` by adding discussion components to units
@@ -50,7 +50,7 @@ the steps below.
 .. warning:: If you make changes to discussion division settings in a running
    course, be aware that learners will be affected by your changes.
 
-1. Navigate to edx discussion provider configuration page
+1. Navigate to Open edX discussion provider configuration page
 (see :ref:`Configuring Edx Discussions`).
 
 2. Turn on the toggle for **Divide discussions by cohort** to divide all
@@ -70,9 +70,9 @@ For information about managing discussions that are divided, see
 
 .. _Divide Course Wide Discussion Topics:
 
-*************************************
+************************************
 Divide Course-Wide Discussion Topics
-*************************************
+************************************
 
 When you create :ref:`course-wide discussion topics<Create CourseWide
 Discussion Topics>`, they are by default unified. All learners in the
@@ -90,7 +90,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 edx discussion provider configuration page (see :ref:`Configuring Edx Discussions`).
+1. Navigate to Open edx discussion provider configuration page (see :ref:`Configuring Edx Discussions`).
 
 2. Turn on the toggle for **Divide discussions by cohort** to divide all
    content-specific discussion topics by cohort.

diff --git a/source/educators/how-tos/communication/setup_cohorted_discussions.rst b/source/educators/how-tos/communication/setup_cohorted_discussions.rst
@@ -2,9 +2,9 @@
 
 .. _Set up Discussions in Cohorted Courses:
 
-######################################################
+##############################################
 Setting up Discussions in Courses with Cohorts
-######################################################
+##############################################
 
 .. tags:: educator, how-to
 

diff --git a/source/educators/how-tos/course_development/create_hide_delete_sections.rst b/source/educators/how-tos/course_development/create_hide_delete_sections.rst
@@ -1,8 +1,8 @@
 .. _Create a Section:
 
-****************************
+################
 Create a Section
-****************************
+################
 
 .. tags:: educator, how-to
 

diff --git a/...ators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst b/...ators/how-tos/course_development/exercise_tools/add_numerical_input_problem.rst
@@ -1,8 +1,8 @@
 .. _Adding Numerical Input Problem: 
 
-***********************************
+################################
 Adding a Numerical Input Problem
-***********************************
+################################
 
 .. tags:: educator, how-to
 
@@ -35,9 +35,9 @@ Creating a numerical input problem is as simple as:
 If you have any questions on the specifics of using the simple editor, please check
 out :ref:`Simple Editor` and :ref:`Problem Settings`.
 
-============================================================
+*****************************
 Adding a Tolerance or a Range
-============================================================
+*****************************
 
 To give learners the option to receive full credit for a close approximation of
 the correct answer, and to support a wide range of possible correct numerical
@@ -51,9 +51,9 @@ to mark as correct for the numerical input problem type.
 .. note:: You can either have a **tolerance** or an **answer range** for a
   numerical input problem. You cannot add both.
 
--------------------
+==================
 Adding a Tolerance
--------------------
+==================
 
 You can specify a margin of error or tolerance for learner responses. You
 can specify a percentage or number. The tolerance settings panel can be
@@ -63,9 +63,9 @@ found to the right of the editor.
  :alt: An example tolerance setting set to 5%.
  :width: 200
 
---------------------------------------
+==========================
 Specifying an Answer Range
---------------------------------------
+==========================
 
 You can specify an answer range so that any learner response within that range
 is marked correct.
@@ -92,12 +92,11 @@ or a combination of one bracket and one parenthesis.
 For example, to identify the correct answers as 5, 6, or 7, but not 8, specify
 ``[5,8)``. To identify the correct answers as 6, 7, and 8, but not 5, specify
 ``(5,8]``.
-.. :diataxis-type: how-to
-.. _Use Feedback in a Numerical Input Problems:
 
-=================
+
+===============
 Adding Feedback
-=================
+===============
 
 For an overview of feedback in problems, see :ref:`Adding Feedback and Hints to
 a Problem`. In numerical input problems, you can provide feedback for correct
@@ -122,9 +121,9 @@ learner submits this answer.
 
 .. _Use Hints in a Numerical Input Problem:
 
-=================
+============
 Adding Hints
-=================
+============
 
 You can add hints to a numerical input problem using the simple editor or the
 advanced editor. For an overview of hints in problems, see