ci: publish the docs after a release succeeds

Author: cadenmyers13

.github/workflows/build-and-publish-docs-on-dispatch.yml

@@ -1,6 +1,8 @@
 name: Build and Publish Docs on Dispatch
 
+# Called by release-github-on-tag.yml after a successful release.
 on:
+  workflow_call:
   workflow_dispatch:
 
 permissions:
@@ -17,6 +19,7 @@ jobs:
       - name: Check out libdiffpy
         uses: actions/checkout@v6
         with:
+          ref: ${{ github.ref }} # The release tag is recreated after the changelog update
           fetch-depth: 0 # Version is read from git tags
 
       - name: Initialize miniconda

.github/workflows/release-github-on-tag.yml

@@ -30,3 +30,9 @@ jobs:
     uses: scikit-package/release-scripts/.github/workflows/_release-github.yml@v0
     secrets:
       PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
+
+  docs-release:
+    needs: [release-github]
+    permissions:
+      contents: write
+    uses: ./.github/workflows/build-and-publish-docs-on-dispatch.yml

news/ci.rst

@@ -7,6 +7,7 @@
 * Run matrix testing with SCons on Ubuntu and macOS (arm64 and Intel) instead of the Python-only pytest matrix.
 * Run matrix testing before every GitHub release and block the release if any test fails.
 * Build and deploy docs with Sphinx directly instead of the Python-only scikit-package docs workflow.
+* Publish docs automatically after a successful GitHub release.
 * Update the release checklist for GitHub and conda-forge releases without PyPI.
 
 **Deprecated:**