Update various Educator docs pages

source/developers/references/aspects_home.rst

@@ -1,3 +1,5 @@
+.. _Aspects Home:
+
 ####################################################
 Aspects: Learner analytics for the Open edX Platform
 ####################################################

source/educators/concepts/open_edx_platform/about_course_sections.rst

@@ -6,8 +6,6 @@ About Course Sections
 
 .. tags:: educator, concept
 
-To develop sections in your course, you must first understand the following topics.
-
 .. contents::
   :local:
   :depth: 2
@@ -16,14 +14,15 @@ To develop sections in your course, you must first understand the following topi
 What Is a Section?
 ****************************
 
-A section is the topmost category in your course. A section can represent a
-time period in your course, a chapter, or another organizing principle. A section contains one or more subsections.
+A section is the topmost category in a course. A section can represent a time
+period in a course, a chapter, or another organizing principle. A section
+contains one or more :ref:`subsections <About Course Subsections>`.
 
 ********************************
 Viewing Sections in the Outline
 ********************************
 
-For more information see :ref:`About the Course Outline`
+For more information see :ref:`About the Course Outline`.
 
 .. _Sections and Visibility to Learners:
 
@@ -42,13 +41,40 @@ if:
 * The unit is not hidden from learners.
 
 ************************************************
-Release Statuses of Sections
+Setting the Release Date for Sections
 ************************************************
 
-As an course author, you control the release status of sections.  For the
-content of a section to be visible to learners, the section must be released.
-See the following topics for more information about the possible release
-statuses of sections.
+For the content of a section to be visible to learners, the section must be
+released. To set the release status for sections, follow these steps.
+
+#. From the three-dot menu at the section level, choose **Configure**.
+
+   .. image:: /_images/educator_concepts/section_three_dot_menu_configure.png
+     :width: 600
+
+#. On the **Basic** tab, locate the **Release date and time** section.
+
+   .. image:: /_images/educator_concepts/section_release_date.png
+     :width: 600
+
+#. For **Release Date** and **Release Time in UTC**, enter or select a due date and
+   time for problems in this section.
+
+   .. note:: The time that you set is in Coordinated Universal Time (UTC). You
+      might want to verify that you have specified the time that you intend by
+      using a time zone converter such as `Time and Date Time Zone Converter`_.
+
+      Learners who have specified a time zone in their account settings see
+      course dates and times converted to their specified time zone. Learners
+      who have not specified a time zone in their account settings see course
+      dates and times on their dashboards, in the body of the course, and on
+      their **Progress** pages in the time zone that their browsers specify.
+      Learners see other course dates and times in UTC.
+
+
+************************************************
+Understanding Section Statuses
+************************************************
 
 .. contents::
   :local:
@@ -58,16 +84,16 @@ statuses of sections.
 Unscheduled
 ========================
 
-If you do not change the :ref:`course start date<Set Start and End Dates>`
-default value, ``1/1/2030 00:00:00 UTC``, when you create a new section, its
+If the :ref:`course start date<Set Start and End Dates>` is unchanged from its
+default value, ``1/1/2030 00:00:00 UTC``, when a new section is created, its
 release date will appear as ``Unscheduled``. When the section release date is
 unscheduled, learners cannot see any content in that section, regardless of
 the publishing status of that content.
 
-If you have modified the course start date, when you create a new section, the
+If the course start date has been modified, when a new section is created, the
 default release date is the course start date.
 
-To make the content available to learners, you must schedule the release date.
+To make the content available to learners, the release date must be scheduled.
 
 ==========
 Scheduled
@@ -91,10 +117,10 @@ published.
 Released with Unpublished Changes
 ==================================
 
-If you change a unit in a released section but do not publish the changes,
+If a unit in a released section is changed but the changes aren't published,
 learners see the last published version of the modified unit.
 
-You must publish the unit for learners to see the updates.
+The unit must published for learners to see the updates.
 
 ===========================
 Staff Only Content
@@ -136,5 +162,5 @@ regardless of the release date of the section or subsection.
 +--------------+-------------------------------+----------------+--------------------------------+
 | Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
 +--------------+-------------------------------+----------------+--------------------------------+
-|              |                               |                |                                |
+| 2025-11-16   | sarina                        |  Ulmo          | Pass                           |
 +--------------+-------------------------------+----------------+--------------------------------+

source/educators/concepts/open_edx_platform/about_course_subsections.rst

@@ -6,9 +6,6 @@ About Course Subsections
 
 .. tags:: educator, concept
 
-To develop subsections in your course, you must first understand the
-following topics.
-
 .. contents::
   :local:
   :depth: 2
@@ -17,23 +14,23 @@ following topics.
 What Is a Subsection?
 ****************************
 
-Sections are divided into subsections, which in turn contain one or more units.
-A subsection may represent a topic in your course, or another organizing
-principle. Subsections are sometimes called "lessons" or they might represent a
-week's worth of material.
+:ref:`Sections <About Course Sections>` are divided into subsections, which in
+turn contain one or more :ref:`units <About Course Units>`. A subsection may
+represent a topic in a course, or another organizing principle. Subsections are
+sometimes called "lessons" or they might represent a week's worth of material.
 
 ***********************************
 Viewing Subsections in the Outline
 ***********************************
 
-For more information see :ref:`About the Course Outline`
+For more information see :ref:`About the Course Outline`.
 
 ************************************************
 Subsections and Visibility to Learners
 ************************************************
 
-Learners cannot see any content in a subsection until you schedule a release
-date, and that release date has passed.
+Learners cannot see any content in a subsection until a release date is
+scheduled, and that release date has passed.
 
 If a subsection's release date has passed, learners can see content in the
 subsection if the following conditions are met.
@@ -43,16 +40,16 @@ subsection if the following conditions are met.
 * The subsection or the units are not hidden from learners.
 
 To control whether learners have access to the subsection and its units after
-a subsection's release date, you can apply various visibility settings.
+a subsection's release date, various visibility settings can be applied.
 
 By default, the subsection and its units are available to learners, except for
-any units that you have explicitly hidden from learners.
+any units that have been explicitly hidden from learners.
 
-You can also choose to entirely hide a subsection so that the subsection and
-its units are not visible to learners at all in the course navigation, or you
-can hide the contents of a subsection after the subsection due date has passed.
-For more information about subsection visibility settings, see :ref:`Hide a
-Subsection from Students`.
+A subsection can be entirely hidden so that the subsection and its units are not
+visible to learners at all in the course navigation. Additionally, the contents
+of a subsection can be hidden after the subsection due date has passed. For more
+information about subsection visibility settings, see :ref:`Hide a Subsection
+from Students`.
 
 
 .. note::
@@ -72,9 +69,8 @@ Subsection from Students`.
 Release Statuses of Subsections
 ************************************************
 
-As a course author, you control the release status of subsections. For the
-content of a subsection to be visible to learners, the subsection must be
-released. See the following topics for more information about the possible
+For the content of a subsection to be visible to learners, the subsection must
+be released. See the following topics for more information about the possible
 release statuses of subsections.
 
 .. contents::
@@ -85,23 +81,23 @@ release statuses of subsections.
 Scheduled with the Section
 ==========================
 
-When you create a subsection, it is set by default to release on the same date
+When a subsection is created, it is set by default to release on the same date
 and time as the section it is in. Therefore, published content in the
 subsection is visible to learners at the date and time the section is released.
 
 When a subsection is in the "Scheduled with Section" state, and the section is
 scheduled, the subsection is visible in the outline with a vertical green bar
 next to the subsection's display name.
 
-You can change the release date for a subsection to be different from the
+The release date for a subsection can be changed to be different from the
 section it is in. For more information, see :ref:`Set a Subsection Release
 Date`.
 
 ========================
 Unscheduled
 ========================
 
-If the parent section is unscheduled, when you create a new subsection it
+If the parent section is unscheduled, when a new subsection is created, it
 will also be unscheduled.
 
 Regardless of the publishing status of units within the subsection, no content
@@ -110,14 +106,14 @@ in an unscheduled subsection is visible to learners.
 When a subsection is unscheduled, the subsection is visible in the outline with
 a vertical gray bar next to the subsection's display name.
 
-Content in the subsection is not visible to learners until you set a release
-date and the date passes.
+Content in the subsection is not visible to learners until a release date is set
+*and* the date passes.
 
 ===================================
 Scheduled Later than the Section
 ===================================
 
-You can set a subsection to release on a date after the section releases.
+A subsection can be set to release on a date after the section releases.
 
 Content in a subsection that is scheduled for release on a future date is not
 visible to learners, even if some or all of the units in the subsection are
@@ -133,28 +129,28 @@ The scheduled date must pass for the subsection to be visible to learners.
 Scheduled with Unpublished Changes
 ==================================
 
-You can make changes to a published unit before its parent subsection
+Changes to a published unit can be made before its parent subsection
 is released.
 
 In this situation, when the release date for the subsection passes, the last
 published version of units within the subsection are made visible to learners.
-The changes in units are not visible to learners until you publish them.
+The changes in units are not visible to learners until they are published.
 
 When a subsection is scheduled but has unpublished changes, the subsection is
 visible in the outline with a vertical yellow bar next to the subsection's
-display name. When you expand the subsection, the unit that has unpublished
+display name. When the subsection is expanded, the unit that has unpublished
 changes is visible.
 
 ==================================
 Released with Unpublished Changes
 ==================================
 
-If you modify a unit within a released subsection, those modifications are not
-visible to students until you publish them.
+If a unit is modified within a released subsection, those modifications are not
+visible to students until they are published.
 
 When a subsection is scheduled but has unpublished changes, the subsection is
 visible in the outline with a vertical yellow bar next to the subsection's
-display name. When you expand the subsection, the unit that has unpublished
+display name. When the the subsection is expanded, the unit that has unpublished
 changes is visible.
 
 ===========================
@@ -179,6 +175,7 @@ When a subsection contains a unit that has staff-only content, the subsection
 is visible in the outline with a vertical black bar next to the subsection's
 display name.
 
+See :ref:`Staff Only Unit` for more detail on unit-level visibility.
 
 .. seealso::
 
@@ -211,5 +208,5 @@ display name.
 +--------------+-------------------------------+----------------+--------------------------------+
 | Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
 +--------------+-------------------------------+----------------+--------------------------------+
-|              |                               |                |                                |
+| 2025-11-16   | sarina                        |  Ulmo          | Pass                           |
 +--------------+-------------------------------+----------------+--------------------------------+