Extract api artifact publishing to separate branch; remove UpdateApiDocs stage

Author: iclanton

common/config/azure-pipelines/npm-post-publish.yaml

@@ -27,11 +27,6 @@ resources:
       type: git
       name: 1ESPipelineTemplates/1ESPipelineTemplates
       ref: refs/tags/release
-    - repository: rushstackWebsites
-      type: github
-      name: microsoft/rushstack-websites
-      endpoint: pipelinesMicrosoftRushstack
-      ref: refs/heads/main
 
 extends:
   template: v1/1ES.Official.PipelineTemplate.yml@1esPipelines
@@ -113,88 +108,3 @@ extends:
                   BranchName: $(BranchName)
                   PrTitle: $(CommitMessage)
                   PrDescription: 'Automated PR to bump decoupled local dependencies to the latest published versions.'
-
-      # ──────────────────────────────────────────────────────────────────────────
-      # Stage 2: Update API documentation on rushstack-websites
-      # ──────────────────────────────────────────────────────────────────────────
-      - stage: UpdateApiDocs
-        displayName: 'Update API documentation'
-        dependsOn: [] # Run in parallel with BumpDecoupledDeps
-        variables:
-          BranchName: 'automated/update-api-docs'
-          CommitMessage: 'docs: update API documentation'
-        jobs:
-          - job:
-            pool:
-              name: publish-rushstack
-              os: linux
-            steps:
-              # Check out both repos. AzDO places them in subdirectories named after the
-              # repo alias when multiple checkouts are used:
-              #   $(Pipeline.Workspace)/s/self  (rushstack)
-              #   $(Pipeline.Workspace)/s/rushstackWebsites  (rushstack-websites)
-              - checkout: self
-                persistCredentials: true
-
-              - checkout: rushstackWebsites
-                persistCredentials: true
-
-              - template: /common/config/azure-pipelines/templates/install-node.yaml@self
-
-              # Download the api artifact from the triggering publish pipeline.
-              # AzDO automatically resolves which pipeline resource triggered this run.
-              - task: DownloadPipelineArtifact@2
-                displayName: 'Download API review files'
-                inputs:
-                  artifact: api
-                  path: $(Pipeline.Workspace)/api
-
-              # Install and build only api-documenter, which is needed to generate
-              # the markdown output from the *.api.json files.
-              - script: 'node common/scripts/install-run-rush.js install'
-                displayName: 'Rush Install'
-                workingDirectory: $(Pipeline.Workspace)/s/self
-
-              - script: 'node common/scripts/install-run-rush.js build --to @microsoft/api-documenter --verbose'
-                displayName: 'Rush Build (api-documenter)'
-                workingDirectory: $(Pipeline.Workspace)/s/self
-
-              # Run api-documenter to generate markdown files from the *.api.json inputs.
-              - script: 'node apps/api-documenter/bin/api-documenter markdown --input-folder $(Pipeline.Workspace)/api --output-folder $(Pipeline.Workspace)/api-markdown'
-                displayName: 'Generate API markdown'
-                workingDirectory: $(Pipeline.Workspace)/s/self
-
-              # Update the API docs folder in rushstack-websites and commit.
-              - bash: |
-                  set -e
-
-                  git config --local user.email rushbot@users.noreply.github.com
-                  git config --local user.name Rushbot
-
-                  # Clear the existing pages and replace with freshly generated markdown.
-                  API_DOCS_DIR="websites/api.rushstack.io/docs/pages"
-                  rm -rf "$API_DOCS_DIR"
-                  mkdir -p "$API_DOCS_DIR"
-                  cp -r "$(Pipeline.Workspace)/api-markdown/." "$API_DOCS_DIR/"
-
-                  # Check for changes (tracked and untracked)
-                  if git diff --quiet && [ -z "$(git ls-files --others --exclude-standard)" ]; then
-                    echo "No API documentation changes detected."
-                    echo "##vso[task.setvariable variable=HasChanges]false"
-                    exit 0
-                  fi
-
-                  echo "##vso[task.setvariable variable=HasChanges]true"
-
-                  git checkout -B $(BranchName)
-                  git add --all
-                  git commit -m "$(CommitMessage)"
-                displayName: 'Update API docs and commit'
-                workingDirectory: $(Pipeline.Workspace)/s/rushstackWebsites
-
-              - template: /common/config/azure-pipelines/templates/push-and-create-github-pr.yaml@self
-                parameters:
-                  BranchName: $(BranchName)
-                  PrTitle: $(CommitMessage)
-                  PrDescription: 'Automated PR to update API reference documentation from the latest published packages.'
-                  WorkingDirectory: $(Pipeline.Workspace)/s/rushstackWebsites

common/config/azure-pipelines/npm-publish-rush.yaml

@@ -42,9 +42,6 @@ extends:
                 - output: pipelineArtifact
                   targetPath: $(Build.ArtifactStagingDirectory)/packages
                   artifactName: packages
-                - output: pipelineArtifact
-                  targetPath: $(Build.ArtifactStagingDirectory)/api
-                  artifactName: api
             steps:
               - checkout: self
                 persistCredentials: true

common/config/azure-pipelines/npm-publish.yaml

@@ -42,9 +42,6 @@ extends:
                 - output: pipelineArtifact
                   targetPath: $(Build.ArtifactStagingDirectory)/packages
                   artifactName: packages
-                - output: pipelineArtifact
-                  targetPath: $(Build.ArtifactStagingDirectory)/api
-                  artifactName: api
             steps:
               - checkout: self
                 persistCredentials: true

common/config/azure-pipelines/templates/post-publish.yaml

@@ -3,8 +3,3 @@ steps:
     displayName: 'Record Published Versions'
   - script: 'node repo-scripts/repo-toolbox/lib-commonjs/start.js collect-json-schemas --output-path $(Build.ArtifactStagingDirectory)/json-schemas'
     displayName: 'Collect JSON Schemas'
-  - bash: |
-      set -e
-      mkdir -p "$(Build.ArtifactStagingDirectory)/api"
-      cp common/temp/api/*.api.json "$(Build.ArtifactStagingDirectory)/api/"
-    displayName: 'Collect API review files'