Provisionally resolve #367 - Improved docs publishing

The only way to test this is on master.  Hence committing straight
into it.

Author: craigfowler

.github/workflows/publishDocsWebsite.yml

@@ -47,20 +47,12 @@ jobs:
         with:
           name: Build results (NuGet)
           path: packages/*.nupkg
-      - name: Publish packages to GitHub feed
-        if: ${{ github.event_name != 'pull_request' && github.ref_name == 'master' }}
-        run: |
-          dotnet nuget add source --username ${{ env.GithubNugetUsername }} --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name github "https://nuget.pkg.github.com/csf-dev/index.json"
-          for package in packages/*.nupkg
-          do
-            dotnet nuget push $package --source github
-          done
 
   build_docs_site:
     name: Build the documentation website
     runs-on: ubuntu-24.04
     timeout-minutes: 30
-    if: ${{ github.event_name == 'push' || github.event.workflow_run.conclusion == 'success' }}
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
 
     steps:
       - name: Checkout
@@ -83,7 +75,7 @@ jobs:
           path: docs/**/*
 
   publish_nuget:
-    name: Publish packages to NuGet
+    name: Publish new Release (Github & NuGet)
     runs-on: ubuntu-slim
     if: ${{ github.event_name == 'push' }}
     needs: build_and_pack
@@ -150,3 +142,63 @@ jobs:
           prerelease: ${{ steps.get-release-props.outputs.prerelease }}
           body_path: release_notes.md
           generate_release_notes: true
+
+  publish_github:
+    name: Publish packages to GitHub
+    runs-on: ubuntu-slim
+    needs: build_and_pack
+    if: ${{ github.event_name != 'pull_request' && github.ref_name == 'master' }}
+
+    env:
+      GithubNugetUsername: craigfowler
+
+    steps:
+      - name: Add .NET global tools location to PATH
+        run: echo "$HOME/.dotnet/tools" >> "$GITHUB_PATH"
+        shell: bash
+      - name: Install .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: 8.0.x
+      - name: Get release artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: Build results (NuGet)
+          path: ./packages
+      - name: Publish packages to GitHub feed
+        run: |
+          dotnet nuget add source --username ${{ env.GithubNugetUsername }} --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name github "https://nuget.pkg.github.com/csf-dev/index.json"
+          for package in packages/*.nupkg
+          do
+            dotnet nuget push $package --api-key ${{ secrets.GITHUB_TOKEN }} --source github
+          done
+
+  update_docs_website:
+    name: Update docs website
+    runs-on: ubuntu-slim
+    needs: build_docs_site
+    if: ${{ github.event_name != 'pull_request' && github.ref_name == 'master' }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Remove old docs
+        run: dotnet clean CSF.Screenplay.Docs
+      - name: Get release artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: Docs website
+          path: ./docs
+      - name: Add & Commit
+        uses: EndBug/add-and-commit@v9.1.4
+        with:
+          add: -A docs/
+          default_author: github_actor
+          committer_name: Github Actions Workflow (bot)
+          committer_email: github-actions-workflow@bots.noreply.github.com
+          fetch: true
+          message: Publish updated documentation website
+          push: origin master