cache mvn, and do you know GNU cp is different from Mac (BSD) cp?

Author: SiyaoIsHiding

.github/workflows/build-docs-gh-pages.yml

@@ -14,26 +14,27 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-#      pull-requests: write
 
     steps:
-      # 1. Checkout doc branch
+      # 1. Checkout current branch
       - name: Checkout current branch
         uses: actions/checkout@v4
 
-      # 2. Java 8
+      # 2. Java 8 (with Maven cache)
       - name: Set up Java 8
         uses: actions/setup-java@v4
         with:
           distribution: temurin
           java-version: "8"
+          cache: maven        # <--- cache Maven deps (~/.m2/repository)
 
-      # 3. Python 3.10.19 + MkDocs + plugins
+      # 3. Python 3.10.19
       - name: Set up Python 3.10.19
         uses: actions/setup-python@v5
         with:
           python-version: "3.10.19"
 
+      # 4. Install MkDocs dependencies
       - name: Install MkDocs dependencies
         run: |
           python -m pip install --upgrade pip
@@ -43,13 +44,13 @@ jobs:
             mkdocs-awesome-pages-plugin \
             mkdocs-macros-plugin
 
-      # 4. Build docs via build-doc.sh
+      # 5. Build docs via build-doc.sh
       - name: Build documentation
         run: |
           chmod +x ./build-doc.sh
           ./build-doc.sh
 
-      # 5. Upload built docs as a ZIP artifact
+      # 6. Upload built docs as a ZIP artifact
       - name: Archive built documentation
         run: |
           zip -r docs-built.zip docs

.github/workflows/update-docs-staging.yml

@@ -27,6 +27,7 @@ jobs:
         with:
           distribution: temurin
           java-version: "8"
+          cache: maven        # <--- cache Maven deps (~/.m2/repository)
 
       # 3. Python 3.10.19 + MkDocs + plugins
       - name: Set up Python 3.10.19
@@ -63,7 +64,7 @@ jobs:
         run: |
           cp -r ../java-driver/docs ./docs/latest
           mkdocs build
-          cp -r ./out/ . # because the index.html has to be in the root folder
+          cp -r ./out/. .      # because the index.html has to be in the root folder
 
       - name: Commit and push to gh-pages-staging
         working-directory: gh-pages-staging