From a5057163f80ffa2bc038fd24781b25c83c80fcab Mon Sep 17 00:00:00 2001 From: Ozohu Adejumo Date: Mon, 24 Nov 2025 20:21:01 +0000 Subject: [PATCH 1/2] Document toggle for maximum courses on homepage Added toggle documentation for HOMEPAGE_COURSE_MAX. --- lms/envs/common.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/lms/envs/common.py b/lms/envs/common.py index 85b4b8af06aa..f657f02d565c 100644 --- a/lms/envs/common.py +++ b/lms/envs/common.py @@ -2910,7 +2910,14 @@ # require student context. MODULESTORE_FIELD_OVERRIDE_PROVIDERS = ('openedx.features.content_type_gating.' 'field_override.ContentTypeGatingFieldOverride',) - +# .. toggle_name: HOMEPAGE_COURSE_MAX +# .. toggle_implementation: DjangoSetting +# .. toggle_default: None +# .. toggle_description: Controls the maximum number of courses displayed on the LMS homepage. +# If set to None, all available courses will be shown. Useful for operators who want to limit the homepage length. +# .. toggle_use_cases: open_edx +# .. toggle_creation_date: 2025-11-24 +# .. toggle_tickets: https://github.com/openedx/edx-platform/issues/37585 # Sets the maximum number of courses listed on the homepage # If set to None, all courses will be listed on the homepage HOMEPAGE_COURSE_MAX = None From 32e584ee6452ddfb5cde60de6ae9ef12a7ea46f6 Mon Sep 17 00:00:00 2001 From: ozohu1 Date: Fri, 16 Jan 2026 18:19:28 +0000 Subject: [PATCH 2/2] docs: add reader context to settings simplification decision --- docs/decisions/0022-settings-simplification.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/decisions/0022-settings-simplification.rst b/docs/decisions/0022-settings-simplification.rst index ed10beeedc4b..4e6890aedafa 100644 --- a/docs/decisions/0022-settings-simplification.rst +++ b/docs/decisions/0022-settings-simplification.rst @@ -8,6 +8,19 @@ Accepted Implementation tracked by: https://github.com/openedx/edx-platform/issues/36215 +Context for Readers +******************* + +This document describes a long-term architectural effort to simplify how Django settings are structured and derived +within edx-platform. + +It is primarily intended for platform maintainers and operators. Contributors who are new to edx-platform, Tutor, +or Open edX configuration may find it helpful to first review the general configuration documentation before diving +into this proposal. + +This decision focuses on architectural direction and incremental refactoring rather than immediate user-facing +behavior changes. + Context *******