openedx · ayub02 · Sep 18, 2025 · Sep 21, 2025 · Sep 24, 2025 · Sep 27, 2025
diff --git a/.github/workflows/upgrade-python-requirements.yml b/.github/workflows/upgrade-python-requirements.yml
@@ -17,7 +17,7 @@ jobs:
       branch: ${{ github.event.inputs.branch || 'main' }}
       # optional parameters below; fill in if you'd like github or email notifications
       # user_reviewers: "feanil"
-      team_reviewers: "docs-openedx-org-maintainers"
+      team_reviewers: "wg-maintenance-docs.openedx.org"
       # email_address: ""
       # send_success_notification: false
       python_version: "3.12"

diff --git a/.gitignore b/.gitignore
@@ -4,4 +4,5 @@ _tags
 source/.DS_Store
 .idea/
 sphinx-env/
-venv/
+.venv/
+sphinx.log
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -17,7 +17,7 @@ sphinx:
 
 # Set the version of python needed to build these docs.
 build:
-  os: "ubuntu-22.04"
+  os: "ubuntu-lts-latest"
   tools:
     python: "3.12"
   apt_packages:

diff --git a/Makefile b/Makefile
@@ -22,8 +22,7 @@ upgrade: export CUSTOM_COMPILE_COMMAND=make upgrade
 upgrade: ## update the requirements/*.txt files with the latest packages satisfying requirements/*.in
 	pip install -r requirements/pip-tools.txt
 	# Make sure to compile files after any other files they include!
-	$(PIP_COMPILE) --allow-unsafe --rebuild -o requirements/pip.txt requirements/pip.in
-	$(PIP_COMPILE) -o requirements/pip-tools.txt requirements/pip-tools.in
+	$(PIP_COMPILE) --allow-unsafe -o requirements/pip-tools.txt requirements/pip-tools.in
 	pip install -r requirements/pip-tools.txt
 	$(PIP_COMPILE) -o requirements/base.txt requirements/base.in
 
@@ -32,7 +31,7 @@ requirements:
 	pip-sync requirements/base.txt
 
 serve_docs: ## serve the built docs locally to preview the site in the browser
-	sphinx-autobuild source $(BUILDDIR)/html
+	sphinx-autobuild source $(BUILDDIR)/html --ignore '**/_tags/*'
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

diff --git a/README.rst b/README.rst
@@ -49,25 +49,11 @@ Build and Test Documentation Locally
 
 For developers comfortable pulling down the repository locally and making changes (see `GitHub Flow`_), you can build the documentation directly on your machine.
 
-To build documentation, inside the root folder, run:
-
-.. code-block:: bash
-
-    make clean
-    make html
-
-Sphinx should build the HTML files locally. To serve the docs locally, run
-
-.. code-block:: bash
-
-    make serve_docs
-
-This is a background process, and it will continue updating the docs as you edit them. However if you make substantive changes, you may need to kill the process and run ``make clean``/``make html`` again. We're fortunate to have a lot of docs - but this means that ``make html`` can take 3-4 minutes to run.
-
-You should ensure the documentation builds with no errors or warnings when submitting a pull request.
+See the `How-to Develop Documentation Locally`_ guide.
 
 .. _Open edX Documentation: https://docs.openedx.org/
 .. _GitHub repository: https://github.com/openedx/docs.openedx.org
 .. _RST: https://en.wikipedia.org/wiki/ReStructuredText
 .. _Sphinx: https://www.sphinx-doc.org/
 .. _GitHub Flow: https://docs.github.com/en/get-started/using-github/github-flow
+.. _How-to Develop Documentation Locally: https://docs.openedx.org/en/latest/documentors/how-tos/develop_docs_locally.html
diff --git a/catalog-info.yaml b/catalog-info.yaml
@@ -8,9 +8,17 @@ metadata:
       title: "Production Site"
       icon: "Web"
   annotations:
+    # NAMED RELEASE NOTE:
+    # This repository gets marked for named releases in a non-standard way!
+    # Standard repsitories get branch `release/X` on the cut date, and tags `release/X.1`,
+    # `release/X.2`, and `release/X.3`on the release dates.
+    # This repo, on the other hand, just gets a `release/X` branch on the X.1 release date.
+    # This is because a lot of documentation happens between the cut date and the X.1 release date;
+    # rather than backporting all those docs, we'd rather just make the branch late.
+    # So, we do not delcare a `openedx.org/release:` key here, because that would confuse the release script.
+    # Instead, the community Release Manager will manually create the `release/X` branch at the right time.
     openedx.org/arch-interest-groups: "feanil"
-    openedx.org/release: "main"
 spec:
-  owner: group:docs-openedx-org-maintainers
+  owner: group:wg-maintenance-docs.openedx.org
   type: 'website'
   lifecycle: 'production'
diff --git a/requirements/base.txt b/requirements/base.txt
@@ -8,21 +8,21 @@ accessible-pygments==0.0.5
     # via pydata-sphinx-theme
 alabaster==1.0.0
     # via sphinx
-anyio==4.10.0
+anyio==4.12.0
     # via
     #   starlette
     #   watchfiles
 babel==2.17.0
     # via
     #   pydata-sphinx-theme
     #   sphinx
-beautifulsoup4==4.13.5
+beautifulsoup4==4.14.2
     # via pydata-sphinx-theme
-certifi==2025.8.3
+certifi==2025.11.12
     # via requests
-charset-normalizer==3.4.3
+charset-normalizer==3.4.4
     # via requests
-click==8.2.1
+click==8.3.1
     # via uvicorn
 colorama==0.4.6
     # via sphinx-autobuild
@@ -33,7 +33,7 @@ docutils==0.21.2
     #   sphinx
 h11==0.16.0
     # via uvicorn
-idna==3.10
+idna==3.11
     # via
     #   anyio
     #   requests
@@ -47,7 +47,7 @@ markdown-it-py==3.0.0
     # via
     #   mdit-py-plugins
     #   myst-parser
-markupsafe==3.0.2
+markupsafe==3.0.3
     # via jinja2
 mdit-py-plugins==0.5.0
     # via myst-parser
@@ -66,7 +66,7 @@ pygments==2.19.2
     #   accessible-pygments
     #   pydata-sphinx-theme
     #   sphinx
-pyyaml==6.0.2
+pyyaml==6.0.3
     # via
     #   myst-parser
     #   sphinxcontrib-mermaid
@@ -77,8 +77,6 @@ requests==2.32.5
     #   sphinxcontrib-youtube
 roman-numerals-py==3.1.0
     # via sphinx
-sniffio==1.3.1
-    # via anyio
 snowballstemmer==3.0.1
     # via sphinx
 soupsieve==2.8
@@ -124,7 +122,7 @@ sphinxcontrib-images==1.0.1
     # via -r requirements/base.in
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
-sphinxcontrib-mermaid==1.0.0
+sphinxcontrib-mermaid==1.2.3
     # via -r requirements/base.in
 sphinxcontrib-qthelp==2.0.0
     # via sphinx
@@ -134,9 +132,9 @@ sphinxcontrib-youtube==1.4.1
     # via -r requirements/base.in
 sphinxemoji==0.3.1
     # via -r requirements/base.in
-sphinxext-rediraffe==0.2.7
+sphinxext-rediraffe==0.3.0
     # via -r requirements/base.in
-starlette==0.48.0
+starlette==0.50.0
     # via sphinx-autobuild
 typing-extensions==4.15.0
     # via
@@ -146,9 +144,9 @@ typing-extensions==4.15.0
     #   starlette
 urllib3==2.5.0
     # via requests
-uvicorn==0.35.0
+uvicorn==0.38.0
     # via sphinx-autobuild
-watchfiles==1.1.0
+watchfiles==1.1.1
     # via sphinx-autobuild
 websockets==15.0.1
     # via sphinx-autobuild
diff --git a/requirements/pip-tools.txt b/requirements/pip-tools.txt
@@ -6,11 +6,11 @@
 #
 build==1.3.0
     # via pip-tools
-click==8.2.1
+click==8.3.1
     # via pip-tools
 packaging==25.0
     # via build
-pip-tools==7.5.0
+pip-tools==7.5.2
     # via -r requirements/pip-tools.in
 pyproject-hooks==1.2.0
     # via
@@ -20,5 +20,9 @@ wheel==0.45.1
     # via pip-tools
 
 # The following packages are considered to be unsafe in a requirements file:
-# pip
-# setuptools
+pip==25.2
+    # via
+    #   -c https://raw.githubusercontent.com/edx/edx-lint/master/edx_lint/files/common_constraints.txt
+    #   pip-tools
+setuptools==80.9.0
+    # via pip-tools
diff --git a/requirements/pip.txt b/requirements/pip.txt
@@ -8,7 +8,7 @@ wheel==0.45.1
     # via -r requirements/pip.in
 
 # The following packages are considered to be unsafe in a requirements file:
-pip==25.2
+pip==25.3
     # via -r requirements/pip.in
 setuptools==80.9.0
     # via -r requirements/pip.in
diff --git a/source/_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png b/source/_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png
diff --git a/source/_images/educator_concepts/Notification_daily_email_screenshot.png b/source/_images/educator_concepts/Notification_daily_email_screenshot.png
diff --git a/source/_images/educator_concepts/Notifications_tray_forum_screenshot.png b/source/_images/educator_concepts/Notifications_tray_forum_screenshot.png
diff --git a/source/_images/educator_concepts/Notifications_tray_grading_screenshot.png b/source/_images/educator_concepts/Notifications_tray_grading_screenshot.png
diff --git a/source/_images/educator_concepts/Notifications_tray_screenshot.png b/source/_images/educator_concepts/Notifications_tray_screenshot.png
diff --git a/...Notifications_tray_updates_screenshot.png → ...Notifications_tray_updates_screenshot.png b/...Notifications_tray_updates_screenshot.png → ...Notifications_tray_updates_screenshot.png
diff --git a/source/_images/educator_concepts/Preference_center.png b/source/_images/educator_concepts/Preference_center.png
diff --git a/source/_images/educator_how_tos/In_Context_Metrics_Graded_Subsection.png b/source/_images/educator_how_tos/In_Context_Metrics_Graded_Subsection.png
diff --git a/source/_images/educator_how_tos/add_lti_component.png b/source/_images/educator_how_tos/add_lti_component.png
diff --git a/source/_images/educator_how_tos/add_lti_store_configuration.png b/source/_images/educator_how_tos/add_lti_store_configuration.png
diff --git a/source/_images/educator_how_tos/create_ltistore_config.png b/source/_images/educator_how_tos/create_ltistore_config.png
diff --git a/source/_images/educator_how_tos/edit_lti_component.png b/source/_images/educator_how_tos/edit_lti_component.png
diff --git a/source/_images/educator_how_tos/entrance_exam_in_outline.png b/source/_images/educator_how_tos/entrance_exam_in_outline.png
diff --git a/source/_images/educator_how_tos/entrance_exam_inst_dash.png b/source/_images/educator_how_tos/entrance_exam_inst_dash.png
diff --git a/source/_images/educator_how_tos/require_entrance_exam.png b/source/_images/educator_how_tos/require_entrance_exam.png
diff --git a/source/_images/learners/Discussions_collapsed_sidebar.png b/source/_images/learners/Discussions_collapsed_sidebar.png
diff --git a/source/_images/learners/Discussions_course_nav.png b/source/_images/learners/Discussions_course_nav.png
diff --git a/source/_images/learners/Discussions_creating_post.png b/source/_images/learners/Discussions_creating_post.png
diff --git a/source/_images/learners/Discussions_edit_delete.png b/source/_images/learners/Discussions_edit_delete.png
diff --git a/source/_images/learners/Discussions_edited_post_banner.png b/source/_images/learners/Discussions_edited_post_banner.png
diff --git a/source/_images/learners/Discussions_elements.png b/source/_images/learners/Discussions_elements.png
diff --git a/source/_images/learners/Discussions_endorsed.png b/source/_images/learners/Discussions_endorsed.png
diff --git a/source/_images/learners/Discussions_filters.png b/source/_images/learners/Discussions_filters.png
diff --git a/source/_images/learners/Discussions_likes.png b/source/_images/learners/Discussions_likes.png
diff --git a/source/_images/learners/Discussions_mark_answer.png b/source/_images/learners/Discussions_mark_answer.png
diff --git a/source/_images/learners/Discussions_mark_answer_indicator.png b/source/_images/learners/Discussions_mark_answer_indicator.png
diff --git a/source/_images/learners/Discussions_notification_activity.png b/source/_images/learners/Discussions_notification_activity.png
diff --git a/source/_images/learners/Discussions_page.png b/source/_images/learners/Discussions_page.png
diff --git a/source/_images/learners/Discussions_pinned_following.png b/source/_images/learners/Discussions_pinned_following.png
diff --git a/source/_images/learners/Discussions_post_closed_banner.png b/source/_images/learners/Discussions_post_closed_banner.png
diff --git a/source/_images/learners/Discussions_report_content.png b/source/_images/learners/Discussions_report_content.png
diff --git a/source/_images/learners/Discussions_reported_banner.png b/source/_images/learners/Discussions_reported_banner.png
diff --git a/source/_images/learners/Discussions_response_comment.png b/source/_images/learners/Discussions_response_comment.png
diff --git a/source/_images/learners/Discussions_response_sort.png b/source/_images/learners/Discussions_response_sort.png
diff --git a/source/_images/learners/Discussions_search.png b/source/_images/learners/Discussions_search.png
diff --git a/source/_images/learners/Discussions_sidebar.png b/source/_images/learners/Discussions_sidebar.png
diff --git a/source/_images/learners/Discussions_tabs.png b/source/_images/learners/Discussions_tabs.png
diff --git a/source/_images/learners/Discussions_topics.png b/source/_images/learners/Discussions_topics.png
diff --git a/source/_images/learners/Notification_daily_email_screenshot_learner.png b/source/_images/learners/Notification_daily_email_screenshot_learner.png
diff --git a/source/_images/learners/Notification_tray_forum_notifications_learner.png b/source/_images/learners/Notification_tray_forum_notifications_learner.png
diff --git a/source/_images/learners/Notifications_preference_learner.png b/source/_images/learners/Notifications_preference_learner.png
diff --git a/source/_images/learners/Notifications_tray_grading_screenshot_learner.png b/source/_images/learners/Notifications_tray_grading_screenshot_learner.png
diff --git a/source/_images/learners/Notifications_tray_screenshot.png b/source/_images/learners/Notifications_tray_screenshot.png
diff --git a/source/_images/learners/Preference_center_learner.png b/source/_images/learners/Preference_center_learner.png
diff --git a/source/_images/learners/discussion_page.png b/source/_images/learners/discussion_page.png
diff --git a/source/community/index.rst b/source/community/index.rst
@@ -9,3 +9,5 @@ Community Home
    how-tos/read_the_roadmap
    security_policy/index
    how-tos/receive_announcements_by_email
+   Community Discussion Boards <https://discuss.openedx.org>
+   Slack Workspace <https://openedx.org/slack>
diff --git a/source/community/release_notes/olive-landing.rst b/source/community/release_notes/olive-landing.rst
@@ -5,9 +5,25 @@ These are the release notes for the Palm release, the 16th community release
 of the Open edX Platform, released in June 2023. You can also review details
 about :doc:`index` or learn more about the `Open edX Platform`_.
 
+.. highlights::
+
+   What's new in Olive? Click to read about new features:
+
+   :ref:`Olive Product Marketing Notes`
+
+   And for more detail on individual products, refer to :ref:`Olive Product Notes`.
+
+.. highlights::
+
+   What's new in Olive? Operators and developers, click to read about new
+   updates, patches, and configuration options.
+
+   :doc:`olive`
+
 .. toctree::
    :maxdepth: 2
 
+   olive/olive_marketing_notes
    olive/feature_release_notes
    olive
 

diff --git a/source/community/release_notes/olive/feature_release_notes.rst b/source/community/release_notes/olive/feature_release_notes.rst
@@ -1,3 +1,5 @@
+.. _Olive Product Notes:
+
 Open edX Olive Release - Feature-Based Notes
 ############################################
 

diff --git a/source/community/release_notes/olive/feature_roundup.rst b/source/community/release_notes/olive/feature_roundup.rst
@@ -10,6 +10,8 @@ additions to the platform, with brief descriptions of what they are.
   :local:
   :depth: 1
 
+.. _Olive randomized:
+
 Resets for Randomized Content Blocks
 ************************************
 
@@ -75,6 +77,8 @@ If you want to help out but don't know where to start, visit us on the
 `Discussion Forums <http://discuss.openedx.org>`_. Instructions for contributing
 are also available `on GitHub <https://github.com/openedx/openedx-test-course#contributing>`_.
 
+.. _Olive pr:
+
 Pages and Resources View
 ************************
 
@@ -93,6 +97,8 @@ that allows you to quickly enable or disable the feature for the course. We'll
 cover the various options available when choosing the Discussion option in a
 future post.
 
+.. _Olive login:
+
 Authentication Micro-frontend (MFE)
 ***********************************
 

diff --git a/source/community/release_notes/olive/olive_3rd_party_discussions.rst b/source/community/release_notes/olive/olive_3rd_party_discussions.rst
@@ -1,3 +1,5 @@
+.. _Olive discussions 3party:
+
 Configuring 3rd Party Discussion Experiences (Olive)
 ####################################################
 

diff --git a/source/community/release_notes/olive/olive_discussions.rst b/source/community/release_notes/olive/olive_discussions.rst
@@ -1,3 +1,5 @@
+.. _Olive discussions:
+
 New and Improved Discussions Forum (Olive)
 ##########################################
 
@@ -90,9 +92,9 @@ moderation team, as well as improvements to course authoring. Site operators can
 find information about how to configure the new Discussions feature in the Olive
 release notes.
 
-*Thank you to `Kshitij Sobti
+Thank you to `Kshitij Sobti
 <https://opencraft.com/a-look-at-the-recent-enhancements-to-discussions-in-open-edx/>`_
-and the team at OpenCraft for the gif shown in this post.*
+and the team at OpenCraft for the gif shown in this post.
 
 
 **Maintenance chart**

diff --git a/source/community/release_notes/olive/olive_discussions_mods.rst b/source/community/release_notes/olive/olive_discussions_mods.rst
@@ -1,3 +1,5 @@
+.. _Olive discussions moderation:
+
 Moderation & Authoring Tools for the New Discussions Feature (Olive)
 ####################################################################
 
@@ -142,9 +144,9 @@ solutions are not built into the Open edX platform, may cost money, and require
 effort from site administrators to enable. See
 :doc:`olive_3rd_party_discussions` for more detail.
 
-*Thank you to `Kshitij Sobti
+Thank you to `Kshitij Sobti
 <https://opencraft.com/a-look-at-the-recent-enhancements-to-discussions-in-open-edx/>`_
-and the team at OpenCraft for the gifs shown in this post.*
+and the team at OpenCraft for the gifs shown in this post.
 
 
 **Maintenance chart**