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
 *******
 
diff --git a/lms/envs/common.py b/lms/envs/common.py
index 0419633f583e..3ca1266b2622 100644
--- a/lms/envs/common.py
+++ b/lms/envs/common.py
@@ -2472,7 +2472,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