Skip to content

Include major version decision in migration guide - #2432

Open
dagood wants to merge 3 commits into
microsoft/mainfrom
dev/dagood/migration-version
Open

Include major version decision in migration guide#2432
dagood wants to merge 3 commits into
microsoft/mainfrom
dev/dagood/migration-version

Conversation

@dagood

@dagood dagood commented Jul 27, 2026

Copy link
Copy Markdown
Member

Try to be a lot more direct about our recommendations and the underlying reasoning.

Try using "current" and "previous" terminology with translation for other (apparently) less common terms.

Break out a dependency pinning section. For now, focuses on the existing topic of pinning to a major version, not immutable dependency pinning to specific builds with auto-updates through Dependabot etc.

Copilot AI review requested due to automatic review settings July 27, 2026 18:55
@dagood
dagood requested a review from a team as a code owner July 27, 2026 18:55
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the migration guide to be more explicit about how to choose a supported Microsoft build of Go “major version” (current vs previous) and how to manage version pinning during and after migration.

Changes:

  • Adds a “What version should I use?” section defining current/previous and recommending selection criteria.
  • Adds a “Dependency pinning” section describing why and how to pin to a major version range (e.g., 1.26.*).
  • Links the quick-start steps to the new version-selection guidance.

Comment thread eng/doc/MigrationGuide.md Outdated
Comment thread eng/doc/MigrationGuide.md
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.

3 participants