January 2025 Endgame

[connor4312]

Sometimes we have slight adjustments to the endgame plan to account for local holidays. Please update your endgame plan accordingly.

• 01/27 Code freeze for the endgame
• 01/28 Endgame starts
• 01/31 Endgame done
• 02/05 Expected release date (this may change)

Monday

• Pin endgame issue on GitHub @connor4312
• Run OSS tool @connor4312
• Update links in the Endgame notebooks to point to new milestone @connor4312
• Code freeze at 5pm PT, PRs should no longer be accepted to ensure a green build
• Ensure we have a green build on all platforms at 5pm PT
• 🔖Ensure all closed feature-requests either have a verification-needed or on-testplan label
• Create test plan items following the template here by 6pm PT
  • Remind the team that TPIs should be written so that anyone can test. If this is not feasible, then TPI authors should assign specific testers @connor4312
• Update your availability for testing here - https://tools.code.visualstudio.com/team-manifest team
  • Update availability of testers in vacation (Check OOF section in the Internal Backlog Plan). Double check N/A testers. @connor4312
  • Remind team that in the event of sickness or overload with TPIs, to inform the endgame champ ASAP so items can be reassigned
• Remind team to go through their fixed issues for the milestone and update repro steps for issues which require more detailed instructions.
• Set up the endgame retrospective to discuss process improvement
  • Schedule an endgame restrospective with @connor4312, endgame buddy, and next @connor4312 for late debt week
  • Create the endgame retrospective tracking issue
• Set up a standup meeting for Friday to discuss candidates

Tuesday

• Test plan items assigned (using https://tools.code.visualstudio.com/test-plan-items)
  • Run the tool multiple times to balance load if test items come in later and assignments are already made
  • Assigned to you
• Test build starts at 7am CET
• Test plan ready by 8am CET
• Remind the team about the priorities
  • Tuesday should be dedicated exclusively to testing activities. Our goal is to ensure the completion of all Test Plan Items (TPIs) and subsequently proceed with the verification phase. Fixes or commits should be refrained from unless there are exceptional circumstances such as blocked TPIs or build-related issues. On Tuesday Redmond EOD, only blocked TPIs should remain open with a corresponding label blocked and status update comment in the issue.
• Testing and Verification
  • 🔖Testing
  • 🔖Verification of Bugs Reported by me
  • 🔖Verification needed
  • 🔖Verification (If verification needed is finished)

Wednesday

• 🔖Testing
  • These remaining TPIs should be the ones that are currently blocked. Discuss during the standup and redistribute assignments based on the TPI owner and the test coverage. For instance, if a TPI is owned by a member from Zurich and has not undergone sufficient testing, it will be reassigned to one of the Zurich team members.
• Remind team members to triage issues found in testing and assign major issues that they intend to fix to the current milestone. Remind team to move out or close other open issues/PRs on the milestone that they do not intend to fix this milestone.
• 🔖Verification needed
• Fixing (self-assigned, milestone assigned)
• 🔖Verification
• Message team members as needed to add steps to verification-steps-needed issues @connor4312

Thursday

• Make sure the insider build is green @connor4312
• Disable continuous insider builds and announce in #release @connor4312

  📢 Continuous insider builds are now disabled.

• Fixing (self-assigned, milestone assigned)
  • Increased scrutiny sets in due to testing being completed. Fixes pose a much higher risk
  • Move open issues/PRs to the next month that can be deferred
• Emphasize to the team that we want to verify as many issues as we can before the branching time, and ping team members as needed to remind them to add steps to verification-steps-needed issues @connor4312
• 🔖Verification needed
• 🔖Verification
• Run scripts/test-documentation.sh|bat after compiling the vscode repo, and fix any issues regarding new undocumented colors. Changes made to the vscode-docs repository must be merged to the main branch of that repository for the script to acknowledge them. False positives within the color section in vscode-known-variables.json can be moved under the others section of that file. @connor4312

Thursday/Friday - Depending on @connor4312 timezone

• By Thursday EOD (Redmond) or Friday BOD (Zurich), branch from main and release @connor4312
  • Branch following repositories to release/<x.y>
    • vscode
    • vscode-distro
    • vscode-dev
  • Localization: Run Update VS Code Branch build with release/* as the VS Code Branch parameter (it's the default so you shouldn't have to change anything)
  • Announce main is open for business and all issues on the current iteration are candidates and that the candidate release process is to be followed.
  • Build and manually release Insider from release/<x.y> branch for Code
  • Build and manually release Insider from release/<x.y> branch for vscode.dev (if there were vscode.dev candidates)
  • Announce in #release @connor4312

    📢 Extension authors ensure all release branch changes have been published to users, manually building and releasing if necessary.

• Build but don't release a stable build from release/<x.y> branch to ensure stable build is green @connor4312
• Bump up the version in package.json on main & run npm i to bump package-lock.json as well. @connor4312
• Create next milestone on microsoft/vscode repo and ensure that it has a due date. The created milestone and its due date will be automatically synced across our repos. @connor4312

Friday

• Only candidate issues are open and assigned to 🔖milestone
• All issues 🔖verified
• All open PRs on the milestone 🔖merged or deferred
• Fix candidate issues (major bugs only)
  • Discuss and get approval in stand up
  • Review and merge into release/<x.y>
  • Queue new auto-published insiders build as candidates are merged @connor4312
  • Author of candidate PR should find verifier
• Satellite modules/npm packages ready, version updated, smoke tested
  • yo generator @aeschli
  • js-debug @connor4312
  • Debug Adapter Protocol @connor4312
  • vscode-debugadapter-node @connor4312
  • vscode-test-web @aeschli
• All release notes updated
  • release notes are collected in a file named _v<Major>_<Minor>.md_ in this repo directory
  • Release notes screen recording guidance: https://microsoft-my.sharepoint.com/:p:/p/buhollan/Ecg_j89jzlVGtfqWGy7SQBEB_OsuLPZ65jjKRVlo_OdlgA
• Documentation added or updated
• Acknowledge third-party pull requests in release notes. @connor4312
• Acknowledge issue trackers from the community @chrmarti
• When done fixing/verifying and there are changes since last build at the end of day PT
  • Build and manually release Insider from release/<x.y> for Code @connor4312
  • Build and manually release Insider from release/<x.y> for vscode.dev (if there were vscode.dev candidates) @connor4312

Monday

• Polish release notes @ntrogh
• Schedule an endgame restrospective with with @connor4312, endgame buddy, and next @connor4312 for this week. Retrospective template
• Decide whether a Patch Tuesday release will happen:
  • Check the internal iteration plan for scheduled security issues (MSRCs) to determine if a Patch Tuesday release is needed.
  • If no Patch Tuesday release is planned, use the Patch Tuesday E-Mail Template to let the Updates team (CSEClientPatching@microsoft.com) know of that fact. Please cc Monacotools on this email as the client patching team has asked us to do so. @connor4312
  • Otherwise, if a Patch Tuesday release is necessary, start off a Patch Tuesday Release plan @connor4312
• Remind the team: if they are going to be OOF for more than five days during the next iteration, assign someone to look out for critical issues in their feature areas and fix them if necessary. This helps with bug identification and fixing for recovery releases. @connor4312

Monday - Wednesday

• 🔖milestone issues
• 🔖candidate issues
• Polish release notes redmond
• Fix candidate issues (major bugs only)
  • Discuss and get approval in stand up
  • Review and merge into release/<x.y>
  • Queue new auto-published insiders build as candidates are merged @connor4312
  • Author of candidate PR should find verifier
• Build but don't release stable for all platforms as new candidate issues come in @connor4312
• Coordinate the official release timing with team and more specifically, team extension authors (ex: Jupyter and Copilot rely on VS Code release) @connor4312

Note: The Insiders build needs to be in the wild for 24 hours before we can enter the last phase of the endgame, though the sanity testing step alone can happen earlier if there are no new candidates. @connor4312

Wednesday/Thursday - Expected release day (this may change)

• Build stable for all platforms @connor4312
• Sanity Testing
  • Windows 64 bit owner
    • System Installer
    • User Installer
    • Archive
    • Server
    • CLI
  • Windows ARM64 owner
    • System Installer
    • User Installer
    • Archive
    • Server
    • CLI
  • macOS Intel owner
    • Archive
    • Universal Archive
    • Server
    • CLI
  • macOS ARM64 owner
    • Archive
    • Universal Archive
    • Server
    • CLI
  • Linux x64 owner
    • Archive
    • DEB
    • RPM
    • Snap
  • Linux Server owner (can be tested from any OS with Docker)
    • x64
    • ARM32
    • ARM64
    • x64 Alpine
    • ARM64 Alpine
  • Linux CLI owner (can be tested from any OS with Docker)
    • x64
    • ARM32
    • ARM64
    • x64 Alpine
    • ARM64 Alpine
• Publish website @ntrogh @connor4312
• Release stable from builds page no later than 11am PT @connor4312
• Trigger the vscode.dev Deploy pipeline for release/x.y for the prod deployment target. Note that there are four deploy approvals needed - one for overall and one per each of the three service regions @connor4312
  • Request approval from another team member at the necessary step to deploy the vscode.dev build. @connor4312
• Create an official release @connor4312
  • Create a tag (make sure you pull the release branch first): git tag <x.y.z>
  • Push the tag: git push origin <x.y.z>
  • Create a GitHub release: Open the GitHub tags, and click far right ... > Create Release. Use the correct title and description from our release notes. Also change the relative links for the key highlight list items to absolute links Example
• X announcement @chrisdias
• Create and publish next release notes placeholder @ntrogh
• Enable scheduled insider builds @connor4312
• Release the latest insiders build based on main from the builds page with all artifacts @connor4312
  • VS Code (Toggle the checkbox of the build)
  • vscode.dev (Run pipeline, change no parameters)
• Publish @types/vscode @connor4312
• Close the milestone on GitHub @connor4312