chore(docs): auto-trigger new feature docs version via release pipeline (#456)

* chore(docs): auto-trigger new feature docs version via release pipeline

* fix(gh): correct gh token

* Update build/templates/trigger-bump-docs-version.yml

* Update trigger-bump-docs-version.yml

Author: stijnmoreels

.github/workflows/bump-docs-version.yml

@@ -0,0 +1,45 @@
+name: Bump new docs version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Specify the new version to bump (e.g. v1.1.0)'
+        required: true
+
+jobs:
+  generate-new-version:
+    runs-on: ubuntu-latest
+  
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+            fetch-depth: 0
+
+      - name: Generate new version
+        run: |
+          cd docs
+          npm install
+          npm run docusaurus docs:version ${{ github.event.inputs.version }}
+
+      - name: Check for changes
+        run: |
+          if git diff --quiet; then
+            echo "No changes detected."
+            exit 0
+          fi
+
+      - name: Configure Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          branch: "docs(${{ github.event.inputs.version }})/bump-docs-version"
+          title: "docs(${{ github.event.inputs.version }}): bump new docs version"
+          body: "This automatically generated PR bumps the docs version to ${{ github.event.inputs.version }}."
+          commit-message: "docs(${{ github.event.inputs.version }}): bump new docs version"
+          delete-branch: true

build/psgallery-release.yml

@@ -56,6 +56,7 @@ resources:
       endpoint: arcus-azure
 
 variables:
+  - group: 'GitHub Configuration'
   - group: 'Build Configuration'
   - group: 'Arcus Scripting - Integration Testing'
   - group: 'Arcus.Scripting - Releasing PS Gallery'
@@ -205,3 +206,6 @@ stages:
             displayName: 'Push to PowerShell Gallery'
             env:
               ARTIFACT_DIR: '$(Build.ArtifactStagingDirectory)'
+          - template: templates/trigger-bump-docs-version.yml
+            parameters:
+              gitHubToken: $(GITHUB_TOKEN)

build/templates/trigger-bump-docs-version.yml

@@ -0,0 +1,19 @@
+parameters:
+  gitHubToken: ''
+
+steps:
+  - script: sudo apt install gh
+    displayName: 'Install GitHub CLI'
+  - powershell: |
+      gh auth login --with-token $(GITHUB_TOKEN)
+      gh repo view
+
+      if ($env:VERSION -notmatch '-' -and $env:VERSION -match '^v[0-9]+\.[0-9]+\.0$') {
+        gh workflow run bump-docs-version.yml `
+          --repo arcus-azure/arcus.testing `
+          --ref main `
+          --field version=$env:VERSION
+      }
+    displayName: 'Trigger new feature docs version PR'
+    env:
+      VERSION: v$(Build.BuildNumber)