Skip to content

docs: add backporting guide and automation#2863

Open
Saadnajmi wants to merge 1 commit intomicrosoft:mainfrom
Saadnajmi:docs-backporting-automation
Open

docs: add backporting guide and automation#2863
Saadnajmi wants to merge 1 commit intomicrosoft:mainfrom
Saadnajmi:docs-backporting-automation

Conversation

@Saadnajmi
Copy link
Collaborator

Summary

Add backporting infrastructure for cherry-picking changes across release branches. This includes:

  • .ai/commands/backport.md — Shared AI-tool-agnostic backport instructions (works with Claude Code, Copilot, or any AI assistant)
  • .claude/commands/backport.md — Claude Code /backport slash command wrapper
  • .github/workflows/microsoft-backport.yml — GitHub Actions workflow triggered by /backport <branch> comments on PRs, with auto-update support when source PR changes
  • docsite/docs/contributing/backporting.md — Documentation page covering all backport methods

Features

  • Multi-branch support: /backport 0.81-stable 0.82-stable
  • Works on both open and merged PRs
  • Auto-updates backport PRs when source PR gets new commits
  • GitHub App authentication via actions/create-github-app-token@v2
  • Handles conflicts gracefully with manual instructions

Test plan

  • Verify docsite builds: cd docsite && yarn start — check "Backporting" page under Contributing
  • Test /backport slash command locally in Claude Code
  • Merge a test PR, comment /backport 0.81-stable, verify workflow creates backport PR

🤖 Generated with Claude Code

Add backporting infrastructure for cherry-picking changes across release
branches:

- .ai/commands/backport.md: shared AI-tool-agnostic backport instructions
- .claude/commands/backport.md: Claude Code slash command wrapper
- .github/workflows/microsoft-backport.yml: GH Actions workflow for
  /backport comments with auto-update support
- docsite/docs/contributing/backporting.md: documentation page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Saadnajmi Saadnajmi requested a review from a team as a code owner March 20, 2026 21:12
@changeset-bot
Copy link

changeset-bot bot commented Mar 20, 2026

⚠️ No Changeset found

Latest commit: 0c5b4c4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants