Merge pull request #25286 from tacaswell/doc/cachebust_switcher

ksunden · web-flow · commit 934951f1aa8b · 2023-02-22T13:08:04.000-06:00
DOC: add cache-busting query to switcher json url
diff --git a/doc/conf.py b/doc/conf.py
@@ -442,7 +442,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'
