-
Notifications
You must be signed in to change notification settings - Fork 57
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
Jswope00/assimilate legacy docs #561
Open
jswope00
wants to merge
14
commits into
openedx:main
Choose a base branch
from
jswope00:jswope00/assimilate_legacy_docs
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
14 commits
Select commit
Hold shift + click to select a range
b145c4f
Assimilate Legacy edX docs 1_general_information into Open edX docs
jswope00 6cd216f
Assimilate Legacy edX docs 2_getting_started into Open edX docs
jswope00 c24e76d
Assimilate Legacy edX docs 3_dashboard_profile into Open edX docs
jswope00 ab05875
Remove reference to tags
jswope00 b05d495
Assimilate Legacy edX docs 4_reaching_learners into Open edX docs
jswope00 a47407a
Assimilate Legacy edX docs 5_accessibility into Open edX docs
jswope00 6bd65b6
[WIP] Assimilate Legacy edx docs 6_setup_course into Open edX docs
jswope00 e766f3f
Assimilate Legacy edX docs 20_glossary into Open edX docs
jswope00 51d40f2
Assimilate Legacy edX docs 19_rerun_course into Open edX Docs
jswope00 62a2961
Assimilate Legacy edX docs 18_student_progress into Open edX Docs
jswope00 a8fcf70
Assimilate Legacy edX docs 18_student_progress into Open edX Docs pt. 2
jswope00 9c432c2
Assimilate Legacy edX docs 17_manage_discussions into Open edX Docs
jswope00 afc3872
Assimilate Legacy edX docs 16_manage_live_course and 15_releasing_cou…
jswope00 a519ec8
Assimilate Legacy edX docs 14_grading into Open edX Docs
jswope00 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added
BIN
+54.4 KB
source/_images/educator_how_tos/discussion_add_post_group_selection.png
Oops, something went wrong.
Oops, something went wrong.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Oops, something went wrong.
Oops, something went wrong.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,3 +6,4 @@ Community Home | |
|
||
release_notes/index | ||
security_policy/index | ||
how-tos/receive_announcements_by_email | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
.. _Accessibility: | ||
|
||
############################# | ||
Accessibility | ||
############################# | ||
|
||
Courses and course content developed on our platform should be accessible to | ||
everyone, regardless of any physical limitation that they might have. | ||
|
||
The topics in this section are intended to help course teams understand how to | ||
develop courses that can serve the widest possible audience. | ||
|
||
.. note:: Course teams should familiarize themselves with this best practices | ||
guidance and distribute it to any members of their teams who are | ||
responsible for creating course content. | ||
|
||
.. toctree:: | ||
:maxdepth: 1 | ||
:glob: | ||
|
||
best_practices_course_content_dev | ||
supporting_learners_diverse_needs | ||
accessibility_guidelines | ||
design_for_mobile |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
69 changes: 69 additions & 0 deletions
69
source/educators/concepts/communication/about_divided_discussions.rst
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
.. :diataxis-type: concept | ||
|
||
.. _About Divided Discussions: | ||
|
||
################################### | ||
About Divided Discussion Topics | ||
################################### | ||
|
||
This section provides information about setting up discussions that are | ||
divided by learner groups (cohorts) within your course. | ||
|
||
.. contents:: | ||
:local: | ||
:depth: 1 | ||
|
||
For overview information about discussions in a course, see :ref:`Discussions`. | ||
|
||
For more information about creating differentiated course content for learners | ||
in different groups (cohorts), see :ref:`Offering Differentiated Content`. | ||
|
||
|
||
****************************** | ||
What Are Divided Discussions? | ||
****************************** | ||
|
||
With divided discussions, discussion topics are visible to all learners, but | ||
the posts, responses, and comments within these topics are divided so that | ||
learners participate in the discussion only with other members of the same | ||
group (cohort). | ||
|
||
Discussion topics that are not divided are unified, meaning that all learners | ||
in the course can see and respond to posts, responses, and comments from any | ||
other learner in the course. | ||
|
||
======================================= | ||
Best Practices for Divided Discussions | ||
======================================= | ||
|
||
If you divide discussions, a good practice is to use a naming convention for | ||
discussion topics, so that learners clearly understand the audience for a | ||
discussion topic before they add posts to that topic. For information about | ||
naming conventions, see :ref:`Apply Naming Conventions to Discussion Topics`. | ||
|
||
You can also appoint learners as Community TAs or Group Commmunity | ||
TAs to help you to moderate course discussions. You might use Group | ||
Community TAs if the content of discussion topics by one group (cohort) should not be | ||
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`. | ||
|
||
For more information about managing discussions, see :ref:`Managing Divided | ||
Discussion Topics` and :ref:`Running_discussions`. | ||
|
||
.. note:: | ||
|
||
Another method of providing different discussion experiences for learners in | ||
different groups in your course is to use the access settings of discussion | ||
components. For example, you can add multiple discussion components and use | ||
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`. | ||
|
||
.. seealso:: | ||
:class: dropdown | ||
|
||
:ref:`Setting Up Divided Discussions` (how-to) | ||
|
107 changes: 107 additions & 0 deletions
107
source/educators/concepts/communication/course_discussions.rst
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,107 @@ | ||
.. :diataxis-type: concept | ||
|
||
.. _Discussions: | ||
|
||
About Course Discussions | ||
########################### | ||
|
||
Discussions in an 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. | ||
|
||
For information about creating discussion topics, see the following sections. | ||
|
||
For information about creating discussions in which learners in a group (cohort) | ||
only interact with posts from other learners in the same group, | ||
see :ref:`About Divided Discussions`. | ||
|
||
For information about running and moderating course discussions, see | ||
:ref:`Running_discussions` and :ref:`Moderating_discussions`. | ||
|
||
.. _Visibility of Discussion Topics: | ||
|
||
Understanding When Learners Can See Discussion Topics | ||
***************************************************** | ||
|
||
The names that you specify as the category and subcategory names for discussion | ||
components are not visible on the Discussion page in the LMS until after | ||
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 | ||
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<Create CourseWide Discussion | ||
Topics>` that you create on the edx 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 | ||
release dates. | ||
|
||
.. _Discussions on Mobile Apps: | ||
|
||
Discussions in the 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 | ||
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. | ||
|
||
* Pinning posts | ||
* Marking responses to question posts as answers | ||
* Endorsing responses to discussion posts | ||
* Closing posts | ||
|
||
.. _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`_. | ||
|
||
.. _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 | ||
course in Studio. Follow the instructions in :ref:`Working with Discussion | ||
Components`. The result is a discussion topic associated with a unit and its | ||
content. Learners can access content-specific topics both in the course unit | ||
and on the Discussion page. | ||
|
||
.. warning:: Follow the recommended steps to add discussion components. Do not | ||
create discussion topics by using the Duplicate button in Studio, and do | ||
not reference the same discussion ID in more than one place in your course. | ||
Duplicated discussion components result in discussion topics that contain the | ||
same conversations, even if learners post in different discussion topics. | ||
|
||
For information about the visibility of content-specific discussion | ||
topics, see :ref:`Visibility of Discussion Topics`. | ||
|
||
.. note:: In courses with cohorts enabled, when you add discussion components to | ||
units in Studio, these discussion topics are by default unified. All learners | ||
in the course can see and respond to posts from all other learners. You can | ||
change content-specific discussion topics to be divided, so that only members | ||
of the same group can see and respond to each other's posts. For information, | ||
see :ref:`Divide All Content Specific Discussion Topics`. | ||
|
||
.. seealso:: | ||
:class: dropdown | ||
|
||
:ref:`Configuring Edx Discussions` (how-to) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
############################# | ||
Communication | ||
############################# | ||
|
||
.. toctree:: | ||
:maxdepth: 1 | ||
:glob: | ||
|
||
* |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is this being added here?