Merge pull request #25289 from meeseeksmachine/auto-backport-of-pr-25286-on-v3.7.x

ksunden · web-flow · commit da8e7653230f · 2023-02-22T20:17:35.000-06:00
Backport PR #25286 on branch v3.7.x (DOC: add cache-busting query to switcher json url)
diff --git a/doc/conf.py b/doc/conf.py
@@ -397,7 +397,11 @@ def js_tag_with_cache_busting(js):
     "collapse_navigation": not is_release_build,
     "show_prev_next": False,
     "switcher": {
-        "json_url": "https://matplotlib.org/devdocs/_static/switcher.json",
+        # Add a unique query to the switcher.json url.  This will be ignored by
+        # the server, but will be used as part of the key for caching by browsers
+        # so when we do a new minor release the switcher will update "promptly" on
+        # the stable and devdocs.
+        "json_url": f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}",
         "version_match": (
             # The start version to show. This must be in switcher.json.
             # We either go to 'stable' or to 'devdocs'
