diff --git a/docs/publishing-your-site.md b/docs/publishing-your-site.md
index 43dd4725f..81d0ca560 100644
--- a/docs/publishing-your-site.md
+++ b/docs/publishing-your-site.md
@@ -40,8 +40,10 @@ contents:
               python-version: 3.x
           - uses: actions/cache@v3
             with:
-              key: ${{ github.ref }}
+              key: mkdocs-material-${{ github.sha }}
               path: .cache
+              restore-keys: |
+                mkdocs-material-
           - run: pip install mkdocs-material # (3)!
           - run: mkdocs gh-deploy --force
     ```
@@ -83,8 +85,10 @@ contents:
               python-version: 3.x
           - uses: actions/cache@v3
             with:
-              key: ${{ github.ref }}
+              key: mkdocs-material-${{ github.sha }}
               path: .cache
+              restore-keys: |
+                mkdocs-material-
           - run: apt-get install pngquant # (1)!
           - run: pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git
           - run: mkdocs gh-deploy --force
diff --git a/docs/setup/ensuring-data-privacy.md b/docs/setup/ensuring-data-privacy.md
index e71e2e1f4..cf039b004 100644
--- a/docs/setup/ensuring-data-privacy.md
+++ b/docs/setup/ensuring-data-privacy.md
@@ -484,7 +484,7 @@ carried out. You might want to:
     `.cache` directory in between builds. Taking the example from the
     [publishing guide], add the following lines:
 
-    ``` yaml hl_lines="15-18"
+    ``` yaml hl_lines="15-20"
     name: ci
       on:
         push:
@@ -501,8 +501,10 @@ carried out. You might want to:
                 python-version: 3.x
             - uses: actions/cache@v3
               with:
-                key: ${{ github.ref }}
+                key: mkdocs-material-${{ github.sha }}
                 path: .cache
+                restore-keys: |
+                  mkdocs-material-
             - run: pip install mkdocs-material
             - run: mkdocs gh-deploy --force
     ```
diff --git a/docs/setup/setting-up-social-cards.md b/docs/setup/setting-up-social-cards.md
index 25df723f6..6cb3e5f4d 100644
--- a/docs/setup/setting-up-social-cards.md
+++ b/docs/setup/setting-up-social-cards.md
@@ -233,7 +233,7 @@ whether the social cards need to be regenerated. You might want to:
     `.cache` directory in between builds. Taking the example from the
     [publishing guide], add the following lines:
 
-    ``` yaml hl_lines="15-18"
+    ``` yaml hl_lines="15-20"
     name: ci
       on:
         push:
@@ -250,8 +250,10 @@ whether the social cards need to be regenerated. You might want to:
                 python-version: 3.x
             - uses: actions/cache@v3
               with:
-                key: ${{ github.ref }}
+                key: mkdocs-material-${{ github.sha }}
                 path: .cache
+                restore-keys: |
+                  mkdocs-material-
             - run: pip install mkdocs-material
             - run: mkdocs gh-deploy --force
     ```