Skip to content

Commit

Permalink
FC-0068 docs: How-to cleaning by edunext #10 (#715)
Browse files Browse the repository at this point in the history 
* FC-0068 docs: How-to cleaning by edunext #10

This PR modifies a series of how-to documents migrated from the legacy repositories to the educators' documentation.  Also creates some how-tos from the cohorted_courseware document.

* Commit fixes

* commit fixes 2

* commit fixes #3

* commit fixes 4

* commit fixes

* commit fixes 6

* Apply suggestions from code review

* Update advanced_features.rst

* Update advanced_features.rst

---------

Co-authored-by: Sarina Canelake <[email protected]>
  • Loading branch information
@Apgomeznext @sarina
Apgomeznext and sarina authored Jan 9, 2025
1 parent 42d8ccb commit 95ce07d
Show file tree
Hide file tree
Showing 10 changed files with 383 additions and 245 deletions.
68 changes: 68 additions & 0 deletions source/educators/how-tos/advanced_features/associate_cohort_with_groups.rst
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
.. _Associate Cohorts with Content Groups:

Associate Cohorts with Content Groups
########################################

.. tags:: educator, how-to

After you :ref:`create a content group<Creating Content Groups>`, you can associate it with one or more cohorts
with which you want to share the same special content.

.. note:: A content group can be associated with more than one cohort; a cohort
cannot be associated with more than one content group.

To associate a cohort with a content group, follow these steps:

#. In the LMS, select **Instructor**, then select **Cohorts**.

#. From the cohorts drop down list, select the cohort to which you want to
associate your content group.

#. Select the **Settings** tab for the selected cohort.

#. Under **Associated Content Group**, choose the **Select a Content Group**
option.

#. From the content group drop down list, select the content group that you
want your cohort to be associated with.

.. image:: /_images/educator_how_tos/Cohorts_AssociateWithContentGroup.png
:alt: Select a content group to associate with the cohort.

#. Select **Save**.

You have now associated your content group with a cohort. Any course content
that you :ref:`designate as available to that content group<Specify Content
as Available Only to Certain Content Groups>` is available to learners in the
associated cohort or cohorts.

You can associate additional cohorts with the same or a different content group
by repeating steps 3 to 7.

For an example of using content groups to create cohort-specific course
content, see :ref:`Cohorted Courseware Example`.

.. seealso::
:class: dropdown

:ref:`Cohorts Overview` (concept)

:ref:`Manage Course Cohorts` (how-to)

:ref:`About Divided Discussions` (concept)

:ref:`Managing Divided Discussion Topics` (concept)

:ref:`Moderating_discussions` (concept)

:ref:`Setting Up Divided Discussions` (how-to)

:ref:`Create Cohort Specific Course Content` (how-to)

:ref:`Creating Content Groups` (how-to)

:ref:`Specify Content as Available Only to Certain Content Groups` (how-to)

:ref:`Viewing Cohort Specific Courseware` (how-to)

:ref:`Delete Content Groups` (how-to)
207 changes: 12 additions & 195 deletions source/educators/how-tos/advanced_features/cohorted_courseware.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ cohorts.
Overview
*********

If you have :ref:`enabled cohorts<Enabling and Configuring Cohorts>` in your
If you have :ref:`Enable Cohorts` in your
course, you can create different course experiences for learners in different
cohorts.

Expand Down Expand Up @@ -121,199 +121,6 @@ only learners in those cohorts will see the designated content.
For an example of using content groups to create cohort-specific course
content, see :ref:`Cohorted Courseware Example`.


.. _Creating Content Groups:

*********************
Create Content Groups
*********************

To create a content group, follow these steps.

#. In Studio, select **Settings**, then select **Group Configurations**.

#. On the **Group Configurations** page, select **New content group**.

.. image:: /_images/educator_how_tos/Cohorts_AddContentGroup.png
:width: 600
:alt: Button on Group Configurations page for adding first content group.

#. Enter a meaningful name for the content group, then select **Create**.
The page refreshes to show the name of your new content group.

#. Repeat this step to create as many content groups as you want.

After you create a content group, you can work with your course outline to
specify which components are available to specific content groups. For details,
see :ref:`Specify Content as Available Only to Certain Content Groups`.

You associate each content group with one or more cohorts in the LMS, on the
instructor dashboard. For details, see :ref:`Associate Cohorts with Content
Groups`.


.. _Specify Content as Available Only to Certain Content Groups:

******************************************************************
Specify Content as Available Only to Particular Content Groups
******************************************************************

In Studio, you can modify the settings of units or components to give access
only to learners who are in cohorts associated with particular content groups.
You cannot specify entire subsections or sections for restricted access by
particular content groups.

You do not need to edit the access settings of units or components that are
intended for all learners. Units or components that you do not restrict access
to are available to all learners enrolled in your course, regardless of the
cohort that they belong to.

.. note:: If a unit has group access restrictions set, all of its child
components inherit these group access restrictions unless you explicitly
set different group access restrictions for individual child components.

For details about how to modify unit access settings, see :ref:`Set Access
Restrictions For a Unit`.

For details about how to modify component access settings, see :ref:`Set Access
Restrictions For a Component`.

For details about previewing your course to ensure that learners in a cohort
correctly see the content intended for them, see :ref:`View Usage of a Content
Group` and :ref:`Viewing Cohort Specific Courseware`.

.. note:: In addition to access settings for content groups, a learner's
ability to see a course component also depends on whether it is marked as
visible to staff only, whether the unit is published, and the course's
release date. For details about testing course content in general, see
:ref:`Testing Your Course Content`.


.. _Associate Cohorts with Content Groups:

*************************************
Associate Cohorts with Content Groups
*************************************

After you create a content group, you can associate it with one or more cohorts
with which you want to share the same special content.

.. note:: A content group can be associated with more than one cohort; a cohort
cannot be associated with more than one content group.

To associate a cohort with a content group, follow these steps:

#. In the LMS, select **Instructor**, then select **Cohorts**.

#. From the cohorts drop down list, select the cohort to which you want to
associate your content group.

#. Select the **Settings** tab for the selected cohort.

#. Under **Associated Content Group**, choose the **Select a Content Group**
option.

#. From the content group drop down list, select the content group that you
want your cohort to be associated with.

.. image:: /_images/educator_how_tos/Cohorts_AssociateWithContentGroup.png
:alt: Select a content group to associate with the cohort.

#. Select **Save**.

You have now associated your content group with a cohort. Any course content
that you :ref:`designate as available to that content group<Specify Content
as Available Only to Certain Content Groups>` is available to learners in the
associated cohort or cohorts.

You can associate additional cohorts with the same or a different content group
by repeating steps 3 to 7.

For an example of using content groups to create cohort-specific course
content, see :ref:`Cohorted Courseware Example`.


.. _Viewing Cohort Specific Courseware:

**************************************
Viewing Cohort-Specific Course Content
**************************************

After you restrict access to units or components to particular content groups,
you can view your course content as a member of a content group to ensure that
members of each group correctly see the content intended for them.

.. note:: In addition to access settings for content groups, a learner's
ability to see a unit or component also depends on whether it is marked as
visible to staff only, whether the unit is published, and the component's
release date. For details about viewing course content in various publishing
states, see :ref:`View Published Content` and :ref:`Preview Unpublished
Content`.

Depending on whether you want to view published content or unpublished content,
you choose either **View Live** or **Preview** from the course outline in
Studio. You can then experience the course content as a learner in a particular
group would, by selecting the **View this course as** option for a learner in
the desired content group, as described in :ref:`Roles for Viewing Course
Content`.

For details about testing course content, see :ref:`Testing Your Course
Content`.


.. _View Usage of a Content Group:

*************************************
View Usage of a Content Group
*************************************

To view the components or units that have been made available to learners in
each of the content groups in your course, follow these steps.

#. In Studio, select **Settings**, then select **Group Configurations**.

#. On the **Group Configurations** page, locate the content group for which you
want to view the usage.

The content group's box displays the number of locations (units or
components) that are designated for learners in cohorts associated with
that content group.

#. Click the content group name to view the names of units and components that
that are specified as available to learners in the group.

#. Click a linked location name to go to that unit in the course outline, where
you can change the group access settings for the unit or component.

For details about previewing your course to ensure that learners in a cohort
correctly see the content intended for them, see :ref:`Viewing Cohort Specific
Courseware`.


.. _Delete Content Groups:

*********************
Delete Content Groups
*********************

.. note:: You can delete a content group only if it is not in use in any course
unit. To delete a content group that is currently in use, you must first
remove it from any course unit visibility settings that use the content
group. For information about seeing which units use a content group, see
:ref:`View Usage of a Content Group`.

#. In Studio, select **Settings**, then select **Group Configurations**.

#. On the **Group Configurations** page, locate the content group that you want
to delete.

#. Move your cursor over the content group's box, then select the **Delete**
icon.

#. In the confirmation message, select **Delete** again to confirm the
deletion.


.. seealso::
:class: dropdown

Expand All @@ -327,4 +134,14 @@ Delete Content Groups

:ref:`Moderating_discussions` (concept)

:ref:`Setting Up Divided Discussions` (how-to)
:ref:`Setting Up Divided Discussions` (how-to)

:ref:`Creating Content Groups` (how-to)

:ref:`Specify Content as Available Only to Certain Content Groups` (how-to)

:ref:`Associate Cohorts with Content Groups` (how-to)

:ref:`Viewing Cohort Specific Courseware` (how-to)

:ref:`Delete Content Groups` (how-to)
54 changes: 54 additions & 0 deletions source/educators/how-tos/advanced_features/create_content_group.rst
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
.. _Creating Content Groups:

Create Content Groups
######################

.. tags:: educator, how-to

To create a content group, follow these steps.

#. In Studio, select **Settings**, then select **Group Configurations**.

#. On the **Group Configurations** page, select **New content group**.

.. image:: /_images/educator_how_tos/Cohorts_AddContentGroup.png
:width: 600
:alt: Button on Group Configurations page for adding first content group.

#. Enter a meaningful name for the content group, then select **Create**.
The page refreshes to show the name of your new content group.

#. Repeat this step to create as many content groups as you want.

After you create a content group, you can work with your course outline to
specify which components are available to specific content groups. For details,
see :ref:`Specify Content as Available Only to Certain Content Groups`.

You associate each content group with one or more cohorts in the LMS, on the
instructor dashboard. For details, see :ref:`Associate Cohorts with Content
Groups`.

.. seealso::
:class: dropdown

:ref:`Cohorts Overview` (concept)

:ref:`Manage Course Cohorts` (how-to)

:ref:`About Divided Discussions` (concept)

:ref:`Managing Divided Discussion Topics` (concept)

:ref:`Moderating_discussions` (concept)

:ref:`Setting Up Divided Discussions` (how-to)

:ref:`Create Cohort Specific Course Content` (how-to)

:ref:`Specify Content as Available Only to Certain Content Groups` (how-to)

:ref:`Associate Cohorts with Content Groups` (how-to)

:ref:`Viewing Cohort Specific Courseware` (how-to)

:ref:`Delete Content Groups` (how-to)
Loading

0 comments on commit 95ce07d

Please sign in to comment.