ci(ghPages): update GitHub Action for pages deployment so it doesnt cause error for branch protection

Author: DevTKSS

.github/workflows/build-deploy-docs.yml

@@ -8,12 +8,6 @@ on:
       - 'src/**'
       - 'README.md'
       - '.github/workflows/build-deploy-docs.yml'
-  pull_request:
-    branches: [ master ]
-    paths:
-      - 'docs/**'
-      - 'src/**'
-      - 'README.md'
   workflow_dispatch:
 
 permissions:
@@ -23,14 +17,12 @@ permissions:
 
 concurrency:
   group: pages
-  cancel-in-progress: false
+  cancel-in-progress: true
 
 jobs:
-  publish-docs:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: windows-latest
+  build-docs:
+    if: ${{ github.ref == 'refs/heads/master' }}
+    runs-on: ubuntu-latest
 
     steps:
       - name: Checkout
@@ -60,6 +52,15 @@ jobs:
         with:
           path: 'docs/_site'
 
+  deploy-docs:
+    needs: build-docs
+    if: ${{ needs.build-docs.result == 'success' && github.ref == 'refs/heads/master' }}
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4