From fb6eaf51413b40208fd20f299b86ccadeb842821 Mon Sep 17 00:00:00 2001
From: Tim McCormack <59623490+timmc-edx@users.noreply.github.com>
Date: Wed, 25 Jun 2025 18:09:10 -0400
Subject: [PATCH] docs: Document how STATIC_URL_BASE is used (#36952)

---
 cms/envs/common.py | 4 ++++
 lms/envs/common.py | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/cms/envs/common.py b/cms/envs/common.py
index 38117b4e4a..07b0b05eb3 100644
--- a/cms/envs/common.py
+++ b/cms/envs/common.py
@@ -1196,6 +1196,10 @@ COURSE_METADATA_EXPORT_BUCKET = ''
 
 ALTERNATE_WORKER_QUEUES = 'lms'
 
+# .. setting_name: STATIC_URL_BASE
+# .. setting_default: "/static/"
+# .. setting_description: The CMS uses this to construct ``STATIC_URL`` by appending
+#   a slash (if needed) and then ``studio/``.
 STATIC_URL_BASE = '/static/'
 
 X_FRAME_OPTIONS = 'DENY'
diff --git a/lms/envs/common.py b/lms/envs/common.py
index ea7f97556c..5559644a62 100644
--- a/lms/envs/common.py
+++ b/lms/envs/common.py
@@ -1920,6 +1920,10 @@ MANAGERS = ADMINS
 # Static content
 STATIC_URL = '/static/'
 STATIC_ROOT = os.environ.get('STATIC_ROOT_LMS', ENV_ROOT / "staticfiles")
+# .. setting_name: STATIC_URL_BASE
+# .. setting_default: "/static/"
+# .. setting_description: The LMS uses this to construct ``STATIC_URL`` by appending
+#   a slash (if needed).
 STATIC_URL_BASE = '/static/'
 
 STATICFILES_DIRS = [