From 04e984deb1d91e892403784c3281cb5128fa95da Mon Sep 17 00:00:00 2001 From: jswope00 Date: Wed, 22 Jan 2025 10:15:30 -0500 Subject: [PATCH] Consolidate redundant create_subscections, and update quickstart (#795) * Consolidate redundant create_subscections, and update quickstart * Add seealso links * fix ref syntax * Change reference from title to reference anchor --- .../create_edit_publish_subsections.rst | 15 ++++++- .../course_development/hide_subsections.rst | 5 +++ .../educators/how-tos/create_subsection.rst | 43 ------------------- .../reusable_content/create_subsection.txt | 42 ------------------ .../educators/navigation/creating_course.rst | 1 - .../educators/quickstarts/build_a_course.rst | 24 ++++++++++- 6 files changed, 41 insertions(+), 89 deletions(-) delete mode 100644 source/educators/how-tos/create_subsection.rst delete mode 100644 source/educators/how-tos/reusable_content/create_subsection.txt diff --git a/source/educators/how-tos/course_development/create_edit_publish_subsections.rst b/source/educators/how-tos/course_development/create_edit_publish_subsections.rst index cdd3f8811..aeddccbe6 100644 --- a/source/educators/how-tos/course_development/create_edit_publish_subsections.rst +++ b/source/educators/how-tos/course_development/create_edit_publish_subsections.rst @@ -6,6 +6,8 @@ Create a Subsection .. tags:: educator, how-to +.. START CREATE A SUBSECTION + To create a new subsection, follow these steps. #. In the outline, expand the section in which you want to create a new @@ -18,6 +20,8 @@ To create a new subsection, follow these steps. analyze performance in reporting and analytics systems. #. :ref:`Add units` to the new subsection as needed. +.. END CREATE A SUBSECTION + It is recommended that you :ref:`test course content ` as you create new subsections. @@ -35,7 +39,7 @@ click outside of the field to save the name. Set a Subsection Release Date ******************************** -To set the subsection release date, follow these steps. +If the subsection should release at a later time than the containing section, set the release date. To set the subsection release date, follow these steps. #. Select the **Configure** icon in the subsection box. @@ -60,10 +64,19 @@ To set the subsection release date, follow these steps. their **Progress** pages in the time zone that their browsers specify. Learners see other course dates and times in UTC. + .. image:: /_images/Educators_subsection_settings_basic.png + :alt: Subsection Settings Basics tab with the Release Date and Grade As fields + :width: 500 + #. Select **Save**. For more information, see :ref:`Release Dates`. +******************************** +Set a Subsection Visibility +******************************** + +To change the visibility of a subsection, see :ref:`Hide a Subsection from Students`. .. _Publish all Units in a Subsection: diff --git a/source/educators/how-tos/course_development/hide_subsections.rst b/source/educators/how-tos/course_development/hide_subsections.rst index 9838eaf7e..a9bd06566 100644 --- a/source/educators/how-tos/course_development/hide_subsections.rst +++ b/source/educators/how-tos/course_development/hide_subsections.rst @@ -46,9 +46,14 @@ To entirely hide a subsection from learners, follow these steps. The subsection settings dialog box opens. + .. image:: /_images/Educators_subsection_settings_visibility.png + :alt: Subsection Settings Visibility tab with the Show entire subsection option selected. + :width: 500 + #. On the **Visibility** tab, locate **Subsection Visibility**, and then select **Hide entire subsection**. + #. Select **Save**. None of the content in the subsection is visible to learners. In the course diff --git a/source/educators/how-tos/create_subsection.rst b/source/educators/how-tos/create_subsection.rst deleted file mode 100644 index eedd9b3a2..000000000 --- a/source/educators/how-tos/create_subsection.rst +++ /dev/null @@ -1,43 +0,0 @@ -Create a Subsection -#################### - -.. tags:: educator, how-to - -.. include:: reusable_content/create_subsection.txt - -.. seealso:: - :class: dropdown - - :ref:`Getting Started with Course Content Development` (reference) - - :ref:`Course Outline` (concept) - - :ref:`Creating a New Course in Studio ` (how-to) - - :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) - - :ref:`Modify Settings for Objects in the Course Outline` (reference) - - :ref:`Publish Content from the Course Outline` (reference) - - :ref:`Developing Course Sections` (reference) - - :ref:`Developing Course Subsections` (reference) - - :ref:`Create a Section` (how-to) - - :ref:`Hiding a Subsection from Learners ` (how-to) - - :ref:`Add Course Metadata` (how-to) - - :ref:`Resources for Open edX Course Teams` (reference) - - :ref:`Resources for Open edX` (reference) diff --git a/source/educators/how-tos/reusable_content/create_subsection.txt b/source/educators/how-tos/reusable_content/create_subsection.txt deleted file mode 100644 index 9db560e02..000000000 --- a/source/educators/how-tos/reusable_content/create_subsection.txt +++ /dev/null @@ -1,42 +0,0 @@ - -.. sidebar:: Subsection Settings Basics tab - - .. thumbnail:: /_images/Educators_subsection_settings_basic.png - -.. sidebar:: Subsection Settings Visibility tab - - .. thumbnail:: /_images/Educators_subsection_settings_visibility.png - - -#. In the course outline, within the section that you want to create the subsection, click :guilabel:`New Subsection`. - - A new subsection is created at the end of the section, with the subsection name selected. - -#. Enter the name for the new subsection. - -#. If the subsection should release a a later time than the containing section, set the release date. - - #. Select the Configure icon in the subsection box. - - The Settings dialog box opens. - - #. Enter the release date and time for the subsection in the Basics tab. - -#. If the subsection is to be graded, in the Settings dialog box, set release a a later time than the containing section, set type of assignment and the due date in the Basics tab. - -#. Click the :guilabel:`Visibility` tab to change the subsection visibility and assessment results visibility. - -#. Click :guilabel:`Save`. - -You can then create units within the subsection. - -.. seealso:: - :class: dropdown - - :ref:`Developing Course Subsections` (reference) - - Grading - - Units - - diff --git a/source/educators/navigation/creating_course.rst b/source/educators/navigation/creating_course.rst index ee0da7e8a..d13e6cc7e 100644 --- a/source/educators/navigation/creating_course.rst +++ b/source/educators/navigation/creating_course.rst @@ -76,7 +76,6 @@ Create a New Course ../how-tos/course_development/create_hide_delete_sections.rst ../how-tos/course_development/exercise_tools/adding_text.rst ../how-tos/publish_units.rst - ../how-tos/create_subsection.rst ../how-tos/view_as_learner.rst ../how-tos/set_up_course/add_metadata.rst ../how-tos/use_section_independently_of_course_outline.rst diff --git a/source/educators/quickstarts/build_a_course.rst b/source/educators/quickstarts/build_a_course.rst index 5ec93e5a3..25dd2650a 100644 --- a/source/educators/quickstarts/build_a_course.rst +++ b/source/educators/quickstarts/build_a_course.rst @@ -39,7 +39,9 @@ Follow the steps below to build your first course. By the end, you will have a f 4. Create a Subsection ********************** -.. include:: ../how-tos/reusable_content/create_subsection.txt +.. include:: ../how-tos/course_development/create_edit_publish_subsections.rst + :start-after: .. START CREATE A SUBSECTION + :end-before: .. END CREATE A SUBSECTION 5. Create a Unit **************** @@ -80,7 +82,25 @@ Follow the steps below to build your first course. By the end, you will have a f .. seealso:: :class: dropdown - :ref: `Edit a Course` (how-to) + :ref:`Creating a New Course` (how-to) + + :ref:`Edit your Course` (how-to) + + :ref:`Create a Section` (how-to) + + :ref:`Create a Subsection` (how-to) + + :ref:`Create a Unit` (how-to) + + :ref:`Add a Video` (how-to) + + :ref:`Create a Text Component` (how-to) + + :ref:`Add a Multiple Choice Problem` (how-to) + + :ref:`Publish a Unit` (how-to) + + :ref:`View As Learner` (how-to)