Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

cleanup for howtos3 #638

Open
wants to merge 40 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 32 commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
8681158
cleanup for howtos3
jesica-greco-zocdoc Dec 6, 2024
4233ab1
cleaning up for adding_mathjax.rst
jesica-greco-zocdoc Dec 6, 2024
1f2692e
cleanup for adding_numerical_input_problem.rst
jesica-greco-zocdoc Dec 6, 2024
2e0b4ae
cleaning up for add_text_input.rst doc
jesica-greco-zocdoc Dec 6, 2024
98c01f9
cleaning up for library_access.rst
jesica-greco-zocdoc Dec 6, 2024
3863871
cleaning up for add_beta_testers.rst
jesica-greco-zocdoc Dec 9, 2024
ba9f72b
cleaning up set_licensing.rst
jesica-greco-zocdoc Dec 9, 2024
0ab2bd9
adjusting and deleting edx ref
jesica-greco-zocdoc Dec 9, 2024
e43d1a0
cleaning up for hide_subsections.rst
jesica-greco-zocdoc Dec 9, 2024
ec32768
cleaning up for create_hide_delete_sections.rst
jesica-greco-zocdoc Dec 9, 2024
0d9e9ca
cleaning up for course_rerun.rst
jesica-greco-zocdoc Dec 9, 2024
807b48e
cleaning up for update_rerun_course.rst
jesica-greco-zocdoc Dec 10, 2024
d21f875
cleaning up for issuing_certificates.rst
jesica-greco-zocdoc Dec 10, 2024
97a6b19
cleaning up for view_course_information.rst
jesica-greco-zocdoc Dec 10, 2024
fae4968
cleaning up for manage_course_enrollements.rst
jesica-greco-zocdoc Dec 10, 2024
5995138
cleaning up for manage_course_grades.rst
jesica-greco-zocdoc Dec 10, 2024
acc38c9
cleaning up for course_answers.rst
jesica-greco-zocdoc Dec 10, 2024
d274ecc
cleaning up for certificate_data.rst
jesica-greco-zocdoc Dec 10, 2024
c01f180
cleanup for download_or_view_learner_data.rst
jesica-greco-zocdoc Dec 10, 2024
ddb3f97
cleaning up for access_anonymized_data.rst
jesica-greco-zocdoc Dec 10, 2024
83fbdcf
cleaning up for send_bulk_email.rst
jesica-greco-zocdoc Dec 10, 2024
1ccce91
cleaning up for review_sent_messages.rst
jesica-greco-zocdoc Dec 10, 2024
3b12285
cleaning up for allow_anonymous_discussions.rst
jesica-greco-zocdoc Dec 10, 2024
d7b27ab
cleaning up for administer_discussions.rst
jesica-greco-zocdoc Dec 10, 2024
fe4f6d0
adjusting reference
jesica-greco-zocdoc Dec 10, 2024
242ab64
cleaning up setup_cohorted_discussions.rst
jesica-greco-zocdoc Dec 10, 2024
40b8775
cleaning up for closing_discussions.rst
jesica-greco-zocdoc Dec 10, 2024
e0bfc5a
cleaning up for assigning_discussion_roles.rst
jesica-greco-zocdoc Dec 10, 2024
8beea1d
cleaning up for setting_up_divided_discussions.rst
jesica-greco-zocdoc Dec 10, 2024
2ca155b
fixing errors
jesica-greco-zocdoc Dec 10, 2024
027b364
adjustments asked by Sarina
jesica-greco-zocdoc Dec 11, 2024
027ec8e
Delete source/educators/how-tos/drag_and_drop_deprecated.rst
jesgreco Dec 11, 2024
0c11589
deleting edx references
jesica-greco-zocdoc Dec 12, 2024
9ba844f
fixing error_ToC
jesica-greco-zocdoc Dec 12, 2024
528c5c1
fixing error ToC deleting file
jesica-greco-zocdoc Dec 12, 2024
ab59763
fixing error undeleting file
jesica-greco-zocdoc Dec 12, 2024
f097184
fixing error_tOC
jesica-greco-zocdoc Dec 13, 2024
76f1c70
fixing error ref
jesica-greco-zocdoc Dec 13, 2024
c580dcc
changing reference to fix error
jesica-greco-zocdoc Dec 13, 2024
c97dbdb
export_course.rst
jesica-greco-zocdoc Dec 13, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions source/educators/how-tos/allow_anonymous_discussions.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
#########################################
Enable/Disable Anonymous Discussion Posts
#########################################

Expand All @@ -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
********************************

Expand All @@ -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
*****************************************

Expand All @@ -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*
Expand Down
30 changes: 13 additions & 17 deletions source/educators/how-tos/communication/administer_discussions.rst
Original file line number Diff line number Diff line change
@@ -1,24 +1,21 @@
.. _Administer Discussions:

##########################
######################
Administer Discussions
##########################
######################

.. tags:: educator, how-to

****************
*************
Edit Messages
****************
*************
jesgreco marked this conversation as resolved.
Show resolved Hide resolved

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.

Expand All @@ -35,9 +32,9 @@ 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
Expand All @@ -64,9 +61,9 @@ 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
Expand All @@ -90,12 +87,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.
Expand All @@ -108,12 +105,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
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Assigning_discussion_roles:

*************************************
#####################################
Assigning Discussion Moderation Roles
*************************************
#####################################

.. tags:: educator, how-to

Expand All @@ -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.
Expand All @@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Review Sent Messages:

********************************
####################
Review Sent Messages
********************************
####################

.. tags:: educator, how-to

Expand Down
8 changes: 4 additions & 4 deletions source/educators/how-tos/communication/send_bulk_email.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Send_Bulk_Email:

**************************************************
############################################
Send an Email Message to Course Participants
**************************************************
############################################

.. tags:: educator, how-to

Expand Down Expand Up @@ -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,
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Setting Up Divided Discussions:

******************************
##############################
Setting Up Divided Discussions
******************************
##############################

.. tags:: educator, how-to

Expand Down Expand Up @@ -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
Expand All @@ -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
Expand 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
Expand All @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

.. _Set up Discussions in Cohorted Courses:

######################################################
##############################################
Setting up Discussions in Courses with Cohorts
######################################################
##############################################

.. tags:: educator, how-to

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Create a Section:

****************************
################
Create a Section
****************************
################

.. tags:: educator, how-to

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Adding Numerical Input Problem:

***********************************
################################
Adding a Numerical Input Problem
***********************************
################################

.. tags:: educator, how-to

Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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.
Expand All @@ -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
Expand All @@ -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
Expand Down
Loading