Merge pull request #5448 from kamilkrzyskow/update-workflows

Fix GitHub Action caching methodology

.github/workflows/documentation.yml

@@ -50,8 +50,10 @@ jobs:
         uses: actions/cache@v3
         id: cache
         with:
-          key: ${{ runner.os }}-${{ hashFiles('.cache/**') }}
+          key: mkdocs-material-${{ github.sha }}
           path: .cache
+          restore-keys: |
+            mkdocs-material-
 
       - name: Install dependencies
         run: sudo apt-get install pngquant

docs/publishing-your-site.md

@@ -38,10 +38,12 @@ contents:
           - uses: actions/setup-python@v4
             with:
               python-version: 3.x
-          - uses: actions/cache@v2
+          - 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
     ```
@@ -81,10 +83,12 @@ contents:
           - uses: actions/setup-python@v4
             with:
               python-version: 3.x
-          - uses: actions/cache@v2
+          - 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

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:
@@ -495,14 +495,16 @@ carried out. You might want to:
       deploy:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v2
+          - uses: actions/checkout@v3
-            - uses: actions/setup-python@v2
+          - uses: actions/setup-python@v4
             with:
               python-version: 3.x
-            - uses: actions/cache@v2
+          - 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
     ```

docs/setup/setting-up-social-cards.md

@@ -232,7 +232,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:
@@ -243,14 +243,16 @@ whether the social cards need to be regenerated. You might want to:
       deploy:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v2
+          - uses: actions/checkout@v3
-            - uses: actions/setup-python@v2
+          - uses: actions/setup-python@v4
             with:
               python-version: 3.x
-            - uses: actions/cache@v2
+          - 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
     ```