August 2024 Endgame

[Tyriar]

• 8/26 Code freeze for the endgame
• 8/30 Endgame done
• 9/4 Expected release date (this may change)

Monday 26th

• [x] Check that all queries in this issue use the current milestone @Tyriar
• [x] Run OSS tool @Tyriar
• [x] Update links in the Endgame notebooks to point to new milestone @Tyriar
• [ ] Code freeze at 5pm PT, PRs should no longer be accepted to ensure a green build
• [x] Ensure we have a green build on all platforms at 5pm PT
• [x] 🔖Ensure all closed feature-requests either have a verification-needed or on-testplan label
• [x] Create test plan items following the template here by 6pm PT
  • [x] 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 @Tyriar
• [x] Update your availability for testing here - https://tools.code.visualstudio.com/team-manifest team
  • [x] Update availability of testers in vacation (Check OOF section in the Internal Backlog Plan). Double check N/A testers. @Tyriar
  • [x] Remind team that in the event of sickness or overload with TPIs, to inform the endgame champ ASAP so items can be reassigned
• [x] Remind team to go through their fixed issues for the milestone and update repro steps for issues which require more detailed instructions.

Tuesday 27th

• [x] 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
• [x] Test build starts at 7am CET
• [x] Test plan ready by 8am CET
• [x] 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.
  • Redmond members commence testing the TPIs authored by Zurich members, enabling them to address any feedback on the following day.
• [x] 🔖Testing
• [x] 🔖Verification needed
• [x] 🔖Verification (If verification needed is finished)

Wednesday 28th

• [x] 🔖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.
• [x] 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.
• [x] 🔖Verification needed
• [x] Fixing (self-assigned, milestone assigned)
• [x] 🔖Verification
• [x] Message team members as needed to add steps to verification-steps-needed issues @Tyriar

Thursday 29th

• [x] Make sure the insider build is green @Tyriar
• [x] Confirm with team extension authors when to disable continuous insider builds (includes vscode.dev publishing). The default time is Thursday EOD (Redmond) @Tyriar
• [x] 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
• [x] 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 @Tyriar
• [x] 🔖Verification needed
• [x] 🔖Verification
• By Thursday EOD (Redmond), branch from main and release @Tyriar (moved to Friday for big AMD->ESM PR)
• [x] 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. @Tyriar

Friday 30th

• [x] By Friday EOD (Zurich), branch from main and release @bpasero, @hediet
  • [x] Merge AMD->ESM changes to main and enforce ESLint rules @bpasero
  • [x] Go over recent PRs and merge main in to enforce ESLint rules @bpasero
  • [x] Declare main open for business with a note on the ESM changes that were done @bpasero
  • [x] Disable the continuous release by toggling the continuous release button on the top-right corner of the Builds page @hediet
  • [x] Branch following repositories to release/<x.y> @hediet
  • [x] vscode
  • [x] vscode-distro
  • [x] vscode-dev
  • [x] 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) @hediet
  • [x] 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. @hediet
  • [x] Build and manually release Insider from release/<x.y> branch for Code @hediet
  • Build and manually release Insider from release/<x.y> branch for vscode.dev (if there were vscode.dev candidates) @hediet
  • [x] Remind team extension authors to check if all release branch changes have been published to users. If not, they need to build and manually release a new prerelease version of their extension. @hediet
• [x] Build but don't release a stable build from release/<x.y> branch to ensure stable build is green @hediet/@Tyriar
• [x] Bump up the version in package.json on main - @hediet/@Tyriar
• [x] Only candidate issues are open and assigned to 🔖milestone
  • [x] @Tyriar: I pinged everyone
• [x] All issues 🔖verified
  • [x] @Tyriar: I pinged everyone
• [x] All open PRs on the milestone 🔖merged or deferred
• [x] candidate fixes should be made for major bugs only - to be discussed in stand-up meeting and approved
• [x] Endgame champion / authors of candidate PRs should find testers to test merged candidates. VS Code candidates should be tested on newly released Insiders.
• Satellite modules/npm packages ready, version updated, smoke tested
  • @Tyriar: Moved to Monday-Wednesday due to ESM changes complicating things
• [x] All release notes updated
  • release notes are collected in a file named `v.md`_ in this repo directory
  • Release notes screen recording guidance: https://microsoft-my.sharepoint.com/:p:/p/buhollan/Ecg_j89jzlVGtfqWGy7SQBEB_OsuLPZ65jjKRVlo_OdlgA
• [x] Acknowledge third-party pull requests in release notes. @Tyriar
• [x] 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 @Tyriar
  • Build and manually release Insider from release/<x.y> for vscode.dev (if there were vscode.dev candidates) @Tyriar

Friday 30th/Monday 2nd

• [x] Polish release notes redmond
• [x] Schedule an endgame restrospective with with @Tyriar, endgame buddy, and next @Tyriar for this week. Retrospective template
• [x] 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. @Tyriar
  • Otherwise, if a Patch Tuesday release is necessary, start off a Patch Tuesday Release plan @Tyriar
• [x] 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. @Tyriar

Monday 2nd - Wednesday 4th

• [x] 🔖milestone issues
• [x] 🔖candidate issues
• [x] Polish release notes redmond
• [x] Cherry-pick hand-picked and reviewed changes to release/<x.y>, and close open candidate issues that have already been merged to the release branch. @Tyriar
• [x] Build Insider from release/<x.y> (roughly on a daily basis) @Tyriar
• [x] Manually release Insider @Tyriar
• [x] Endgame champion / authors of candidate PRs should find testers to test merged candidates. VS Code candidates should be tested on newly released Insiders. team
• [x] Build but don't release stable for all platforms as new candidate issues come in @Tyriar
• [x] Documentation updated
• [x] :runner: 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. @Tyriar
  • [x] @Tyriar: Ran, but would like a change to some keys so they don't change in a later
  • [x] Deferring to @ntrogh in https://github.com/microsoft/vscode-docs/issues/7550 release https://github.com/microsoft/vscode/issues/226792
• [x] Coordinate the official release timing with team and more specifically, team extension authors (ex: Jupyter and Copilot rely on VS Code release) @Tyriar
• [x] Satellite modules/npm packages ready, version updated, smoke tested
  • [x] yo generator @aeschli
  • [x] js-debug @connor4312
  • [x] Debug Adapter Protocol @connor4312
  • [x] vscode-debugadapter-node @connor4312
  • [x] vscode-test-web @aeschli

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. @Tyriar

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

• [x] Build stable for all platforms @Tyriar
• [x] Build but don't release an insider build based on main for all platforms @Tyriar
• [x] Sanity Testing
  • [x] Windows 64 bit @Tyriar
  • [x] System Installer
  • [x] User Installer
  • [x] Archive
  • [x] Server
  • [x] CLI
  • [x] Windows ARM64 @jrieken
  • [x] System Installer
  • [x] User Installer
  • [x] Archive
  • [x] Server
  • [x] CLI
  • [x] macOS Intel @isidorn
  • [x] Archive
  • [x] Universal Archive
  • [x] Server
  • [x] CLI
  • [x] macOS ARM64 @sandy081
  • [x] Archive
  • [x] Universal Archive
  • [x] Server
  • [x] CLI
  • [x] Linux x64 @aeschli
  • [x] Archive
  • [x] DEB
  • [x] RPM
  • [x] Snap
  • [x] Linux Server @chrmarti (can be tested from any OS with Docker)
  • [x] x64
  • [x] ARM32
  • [x] ARM64
  • [x] x64 Alpine
  • [x] ARM64 Alpine
  • [x] Linux CLI @dbaeumer (can be tested from any OS with Docker)
  • [x] x64
  • [x] ARM32
  • [x] ARM64
  • [x] x64 Alpine
  • [x] ARM64 Alpine
• [x] Publish website>) @ntrogh @Tyriar
• [x] Release stable from builds page no later than 11am PT @Tyriar
• [x] 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 @Tyriar
  • [x] Request approval from another team member at the necessary step to deploy the vscode.dev build. @Tyriar
• [x] Create an official release @Tyriar
  • [x] Create a tag (make sure you pull the release branch first): git tag <x.y.z>
  • [x] Push the tag: git push origin <x.y.z>
  • [x] 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] X announcement @chrisdias
• [x] Create and publish next release notes placeholder @ntrogh
• [x] Enable scheduled insider builds @Tyriar
• [x] Release insiders based on main @Tyriar
• [x] Publish @types/vscode @Tyriar
• [x] Close the milestone on GitHub @Tyriar

[iwangbowen]

can we get the update today

[gjsjohnmurray]

• Release insiders based on main @Tyriar

As this was marked complete yesterday shouldn't I be seeing an update available for my Insiders? It's still 1.93.0

Version: 1.93.0-insider
Commit: 4849ca9bdf9666755eb463db297b69e5385090e3
Date: 2024-09-04T13:13:15.344Z
Browser: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Code-Insiders/1.93.0-insider Chrome/124.0.6367.243 Electron/30.4.0 Safari/537.36

[Tyriar]

@gjsjohnmurray that was only a recent change to endgame where we want to release main of insiders right after stable. I did it but we had to freeze and then rollback the release as changes with recent the big ESM changes caused some breakages. The new insiders should be out now.