Merge branch 'main' into dependabot/pip/cryptography-42.0.4

.github/workflows/publish-docs.yml

@@ -2,13 +2,10 @@ name: publish-docs
 
 on:
   push:
-    # Publish `main` as latest
+    # Publish `main` as latest, and when pushes are done to branches with "v-doc" prefix
     branches:
       - main
-
-    # Publish `v1.2.3` tags as releases
-    tags:
-      - v*
+      - docs-v*
 
 permissions:
   contents: write
@@ -39,14 +36,15 @@ jobs:
           # Strip git ref prefix from version
           echo "${{ github.ref }}"
           VERSION=$(echo "${{ github.ref }}" | sed -e 's,.*/\(.*\),\1,')
-          # Strip "v" prefix from tag name
-          [[ "${{ github.ref }}" == "refs/tags/"* ]] && ALIAS=$(echo $VERSION | sed -e 's/^v//')
+          # Strip "docs-v" prefix from branch name
+          [[ "$VERSION" == "docs-v"* ]] && ALIAS=$(echo $VERSION | sed -e 's/^docs-v//') && VERSION=${ALIAS}
           # Copy all of the root level md files into the docs folder for deployment, tweaking the relative paths
           for i in *.md; do sed -e "s#docs/#./#g" $i >docs/$i; done
           # Populate overrides for the current version, and then remove to not apply if VERSION is main branch
-          echo -e "{% extends "base.html" %}\n\n{% block outdated %}\n  You are viewing the documentation for ACA-Py Release $VERSION.\n{% endblock %}" >overrides/base.html
-          # If building from main, use latest as ALIAS
-          [ "$VERSION" == "main" ] && ALIAS=latest && rm overrides/base.html
+          OVERRIDE=overrides/main.html
+          echo -e "{% extends \"base.html\" %}\n\n{% block outdated %}\n  You are viewing the documentation for ACA-Py Release $ALIAS.\n{% endblock %}" >$OVERRIDE
+          # If building from main, use latest as ALIAS and remove the override
+          [ "$VERSION" == "main" ] && ALIAS=latest && rm $OVERRIDE
           echo $VERSION $ALIAS
           mike deploy --push --update-aliases $VERSION $ALIAS
           mike set-default latest