Unified gh-pages creation

.github/workflows/docs.yml

@@ -1,16 +1,17 @@
 name: Docs
 
 on:
-  push:
-    branches:
-      - master
   pull_request:
     types: [opened, synchronize, reopened, ready_for_review, labeled]
   merge_group:
+  workflow_call:
+    outputs:
+      run:
+        value: ${{ github.run_id }}
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
-  cancel-in-progress: true
+  group: ${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/master' }}
 
 jobs:
   preflight:
@@ -87,47 +88,3 @@ jobs:
           path: ./artifacts/
           retention-days: 1
           if-no-files-found: error
-
-  publish-rustdoc:
-    if: github.ref == 'refs/heads/master'
-    runs-on: ubuntu-latest
-    environment: subsystem-benchmarks
-    needs: [build-rustdoc, build-implementers-guide]
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: gh-pages
-      - uses: actions/create-github-app-token@v1
-        id: app-token
-        with:
-          app-id: ${{ secrets.POLKADOTSDK_GHPAGES_APP_ID }}
-          private-key: ${{ secrets.POLKADOTSDK_GHPAGES_APP_KEY }}
-      - name: Ensure destination dir does not exist
-        run: |
-          rm -rf book/
-          rm -rf ${REF_NAME}
-        env:
-          REF_NAME: ${{ github.head_ref || github.ref_name }}
-      - name: Download rustdocs
-        uses: actions/download-artifact@v4
-        with:
-          name: ${{ github.sha }}-doc
-          path: ${{ github.head_ref || github.ref_name }}
-      - name: Download guide
-        uses: actions/download-artifact@v4
-        with:
-          name: ${{ github.sha }}-guide
-          path: /tmp
-      - run: mkdir -p book
-      - name: Move book files
-        run: mv /tmp/book/html/* book/
-      - name: Push to GH-Pages branch
-        uses: github-actions-x/[email protected]
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          push-branch: "gh-pages"
-          commit-message: "___Updated docs for ${{ github.head_ref || github.ref_name }}___"
-          force-add: "true"
-          files: ${{ github.head_ref || github.ref_name }}/ book/
-          name: devops-parity
-          email: [email protected]

.github/workflows/publish-gh-pages.yml

@@ -0,0 +1,57 @@
+name: Publish GH-Pages
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build-docs:
+    # TODO: remove once GHA-migration migration is complete or this workflow is fully stable
+    if: false
+    uses: ./.github/workflows/docs.yml
+    secrets: inherit
+
+  publish-rustdoc:
+    runs-on: ubuntu-latest
+    environment: subsystem-benchmarks
+    needs: [build-docs]
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.POLKADOTSDK_GHPAGES_APP_ID }}
+          private-key: ${{ secrets.POLKADOTSDK_GHPAGES_APP_KEY }}
+      - uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+          token: ${{ steps.app-token.outputs.token }}
+      - name: Ensure destination dir does not exist
+        run: |
+          rm -rf book/
+          rm -rf ${REF_NAME}
+        env:
+          REF_NAME: ${{ github.head_ref || github.ref_name }}
+      - name: Download rustdocs
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ github.sha }}-doc
+          path: ${{ github.head_ref || github.ref_name }}
+          run-id: ${{ needs.build-docs.outputs.run }}
+      - name: Download guide
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ github.sha }}-guide
+          path: /tmp
+          run-id: ${{ needs.build-docs.outputs.run }}
+      - run: mkdir -p book
+      - name: Move book files
+        run: mv /tmp/book/html/* book/
+      - name: Set user
+        run: |
+          git config --global user.email "[email protected]"
+          git config --global user.name "devops-parity"
+      - run: git add ${{ github.head_ref || github.ref_name }}/ book/
+      - run: git commit --amend -m "___Updated docs" || echo "___Nothing to commit___"
+      - name: Push docs
+        run: git push origin gh-pages --force