Merge branch 'main' into egorp/ai-docs-fix

Author: egorpavlikhin

.github/CODEOWNERS

@@ -187,17 +187,17 @@
 
 /docs/packaging-applications/index.md @OctopusDeploy/team-marketing
 
-# updates to the packaging applications create packages page are reviewed by team-server-at-scale
+# updates to the packaging applications create packages page are reviewed by team-executions-foundations
 
-/docs/packaging-applications/create-packages/index.md @OctopusDeploy/team-server-at-scale
+/docs/packaging-applications/create-packages/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the packaging applications builder servers page are reviewed by team-modern-deployments
 
 /docs/packaging-applications/build-servers/ @OctopusDeploy/team-modern-deployments
 
-# updates to the packaging applications packaging repositories page are reviewed by team-server-at-scale
+# updates to the packaging applications packaging repositories page are reviewed by team-executions-foundations
 
-/docs/packaging-applications/package-repositories/index.md @OctopusDeploy/team-server-at-scale
+/docs/packaging-applications/package-repositories/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the releases overview page are reviewed by team-marketing
 
@@ -211,13 +211,13 @@
 
 /docs/releases/channels/ @OctopusDeploy/team-modelling-at-scale
 
-# updates to the guided failures page are reviewed by team-server-at-scale
+# updates to the guided failures page are reviewed by team-executions-foundations
 
-/docs/releases/guided-failures.md @OctopusDeploy/team-server-at-scale
+/docs/releases/guided-failures.md @OctopusDeploy/team-executions-foundations
 
-# updates to the prevent release progression page are reviewed by team-server-at-scale
+# updates to the prevent release progression page are reviewed by team-executions-foundations
 
-/docs/releases/prevent-release-progression.md @OctopusDeploy/team-server-at-scale
+/docs/releases/prevent-release-progression.md @OctopusDeploy/team-executions-foundations
 
 # updates to the releases deleting releases page are reviewed by team-modelling-at-scale
 
@@ -255,13 +255,13 @@
 
 /docs/deployments/databases/ @OctopusDeploy/team-modern-deployments
 
-# updates to the deployments docker section are reviewed by team-modern-deployments
+# updates to the deployments Docker section are reviewed by team-modern-deployments
 
 /docs/deployments/docker/ @OctopusDeploy/team-modern-deployments
 
-# updates to the deployments packages page are reviewed by team-server-at-scale
+# updates to the deployments packages page are reviewed by team-executions-foundations
 
-/docs/deployments/packages/index.md @OctopusDeploy/team-server-at-scale
+/docs/deployments/packages/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the deployments custom scripts section are reviewed by team-modelling-at-scale
 
@@ -275,29 +275,29 @@
 
 /docs/runbooks/index.mdx @OctopusDeploy/team-marketing
 
-# updates to the runbooks runbooks vs deployments page are reviewed by team-server-at-scale
+# updates to the runbooks runbooks vs deployments page are reviewed by team-executions-foundations
 
-/docs/runbooks/runbooks-vs-deployments/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/runbooks-vs-deployments/index.md @OctopusDeploy/team-executions-foundations
 
-# updates to the runbooks runbook permissions page are reviewed by team-server-at-scale
+# updates to the runbooks runbook permissions page are reviewed by team-executions-foundations
 
-/docs/runbooks/runbook-permissions/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/runbook-permissions/index.md @OctopusDeploy/team-executions-foundations
 
-# updates to the runbooks runbook variables page are reviewed by team-server-at-scale
+# updates to the runbooks runbook variables page are reviewed by team-executions-foundations
 
-/docs/runbooks/runbook-variables/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/runbook-variables/index.md @OctopusDeploy/team-executions-foundations
 
-# updates to the runbooks runbook publishing page are reviewed by team-server-at-scale
+# updates to the runbooks runbook publishing page are reviewed by team-executions-foundations
 
-/docs/runbooks/runbook-publishing/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/runbook-publishing/index.md @OctopusDeploy/team-executions-foundations
 
-# updates to the runbooks scheduled runbook triggers page are reviewed by team-server-at-scale
+# updates to the runbooks scheduled runbook triggers page are reviewed by team-executions-foundations
 
-/docs/runbooks/scheduled-runbook-trigger/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/scheduled-runbook-trigger/index.md @OctopusDeploy/team-executions-foundations
 
-# updates to the runbooks scheduled runbook examples page are reviewed by team-server-at-scale
+# updates to the runbooks scheduled runbook examples page are reviewed by team-executions-foundations
 
-/docs/runbooks/runbook-examples/index.md @OctopusDeploy/team-server-at-scale
+/docs/runbooks/runbook-examples/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the tasks section are reviewed by team-backend-foundations
 
@@ -347,9 +347,9 @@
 
 /docs/octopus-rest-api/octopus.server.exe-command-line/index.md @OctopusDeploy/team-backend-foundations
 
-# updates to the octopus rest api tentacle exe command line page are reviewed by team-server-at-scale
+# updates to the octopus rest api tentacle exe command line page are reviewed by team-executions-foundations
 
-/docs/octopus-rest-api/tentacle.exe-command-line/index.md @OctopusDeploy/team-server-at-scale
+/docs/octopus-rest-api/tentacle.exe-command-line/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the calamari page are reviewed by team-modern-deployments
 
@@ -411,9 +411,9 @@
 
 /docs/security/http-security-headers.md @OctopusDeploy/team-backend-foundations
 
-# updates to the security octopus tentacle communication page are reviewed by team-server-at-scale
+# updates to the security octopus tentacle communication page are reviewed by team-executions-foundations
 
-/docs/security/octopus-tentacle-communication/index.md @OctopusDeploy/team-server-at-scale
+/docs/security/octopus-tentacle-communication/index.md @OctopusDeploy/team-executions-foundations
 
 # updates to the security authentication providers section are reviewed by team-product-growth
 
@@ -423,9 +423,9 @@
 
 /docs/security/data-encryption.md @OctopusDeploy/team-backend-foundations
 
-# updates to the security built-in worker page are reviewed by team-server-at-scale
+# updates to the security built-in worker page are reviewed by team-executions-foundations
 
-/docs/security/built-in-worker.md @OctopusDeploy/team-server-at-scale
+/docs/security/built-in-worker.md @OctopusDeploy/team-executions-foundations
 
 # updates to the users and teams page are reviewed by team-backend-foundations
 

.github/workflows/branch-markdown.yml

@@ -0,0 +1,91 @@
+name: Markdown
+
+on: pull_request
+
+# Allow this job to clone the repo
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Fetch all history for comparison
+
+      - name: Get changed markdown files
+        id: changed-files
+        run: |
+          # Fetch the base branch
+          git fetch origin ${{ github.base_ref }}
+          
+          # Get changed .md and .mdx files
+          CHANGED_FILES=$(git diff --name-only --diff-filter=ACMRT origin/${{ github.base_ref }}...HEAD | grep -E '\.(md|mdx)$' || true)
+          
+          # Store the files
+          echo "files<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGED_FILES" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+          
+          # Count files
+          if [ -z "$CHANGED_FILES" ]; then
+            echo "count=0" >> $GITHUB_OUTPUT
+          else
+            echo "count=$(echo "$CHANGED_FILES" | wc -l)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Install pnpm
+        if: steps.changed-files.outputs.count > 0
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.13.1
+          run_install: false
+
+      - name: Setup Node
+        if: steps.changed-files.outputs.count > 0
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+          cache-dependency-path: 'pnpm-lock.yaml'
+
+      - name: Get pnpm store directory
+        if: steps.changed-files.outputs.count > 0
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - uses: actions/cache@v3
+        if: steps.changed-files.outputs.count > 0
+        name: Setup pnpm cache
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: PNPM install
+        if: steps.changed-files.outputs.count > 0
+        run: |
+          echo; echo "cd to workspace"
+          cd $GITHUB_WORKSPACE
+          echo; echo "listing"
+          ls
+          echo; echo "PNPM install"
+          pnpm install
+
+      - uses: DavidAnson/markdownlint-cli2-action@v22
+        if: steps.changed-files.outputs.count > 0
+        with:
+          config: '.markdownlint.json'
+          globs: ${{ steps.changed-files.outputs.files }}

.github/workflows/branch-spellcheck.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
 

.github/workflows/branch-validation-full.yml

@@ -38,7 +38,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
 

.github/workflows/branch-validation.yml

@@ -37,7 +37,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
 

.github/workflows/build-astro-full.yml

@@ -38,7 +38,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
 

.github/workflows/build-astro.yml

@@ -40,7 +40,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
 

.markdownlint.json

@@ -1,5 +1,6 @@
 {
     "MD013": false,
+    "MD041": false,
     "emphasis": { "style": "asterisk" },
     "no-inline-html": false,
     "ul-style": { "style": "dash" }

.vscode/settings.json

@@ -5,5 +5,6 @@
     },
     "[markdown]": {
     },
-    "markdownlint.run": "onSave"
+    "markdownlint.run": "onSave",
+    "markdown.replaceSmartQuotes": true
 }

README.md

@@ -28,6 +28,7 @@ When you need to use an example value in docs, please use the below:
 - Octopus API key: `API-YOUR-KEY`
 - Snapshot name: `Snapshot XXXXX`
 - SubscriptionId: `g3662re9njtelsyfhm7t`
+- Fake password: `your-secret-password`
 
 In general, try to use "your" rather than "my". For example, `your-value`.