|
6 | 6 | # Release candidate (Monday, XXX XX)
|
7 | 7 |
|
8 | 8 | - [ ] Announce the code freeze on both Teams and e-mail, leave enough time for teams to surface any last minute issues that need to get in before freeze. Make sure debugger and Language Server teams are looped in as well.
|
9 |
| -- [ ] Update master for the release |
10 |
| - - [ ] Create a branch against `master` for a pull request |
11 |
| - - [ ] Change the version in [`package.json`](https://github.com/Microsoft/vscode-python/blob/master/package.json) from a `-dev` suffix to `-rc` (🤖) |
12 |
| - - [ ] Run `npm install` to make sure [`package-lock.json`](https://github.com/Microsoft/vscode-python/blob/master/package.json) is up-to-date (🤖) |
| 9 | +- [ ] Update `main` for the release |
| 10 | + - [ ] Create a branch against `main` for a pull request |
| 11 | + - [ ] Change the version in [`package.json`](https://github.com/Microsoft/vscode-python/blob/main/package.json) from a `-dev` suffix to `-rc` (🤖) |
| 12 | + - [ ] Run `npm install` to make sure [`package-lock.json`](https://github.com/Microsoft/vscode-python/blob/main/package.json) is up-to-date (🤖) |
13 | 13 | - [ ] Extension will pick up latest version of `debugpy`. If you need to pin to a particular version see `install_debugpy.py`.
|
14 | 14 | - [ ] Update `languageServerVersion` in `package.json` to point to the latest version of the [Language Server](https://github.com/Microsoft/python-language-server). Check with the language server team if this needs updating.
|
15 |
| - - [ ] Update [`CHANGELOG.md`](https://github.com/Microsoft/vscode-python/blob/master/CHANGELOG.md) (🤖) |
16 |
| - - [ ] Run [`news`](https://github.com/Microsoft/vscode-python/tree/master/news) (typically `python news --final --update CHANGELOG.md | code-insiders -`) |
| 15 | + - [ ] Update [`CHANGELOG.md`](https://github.com/Microsoft/vscode-python/blob/main/CHANGELOG.md) (🤖) |
| 16 | + - [ ] Run [`news`](https://github.com/Microsoft/vscode-python/tree/main/news) (typically `python news --final --update CHANGELOG.md | code-insiders -`) |
17 | 17 | - [ ] Copy over the "Thanks" section from the previous release into the "Thanks" section for the new release
|
18 |
| - - [ ] Make sure the "Thanks" section is up-to-date (e.g. compare to versions in [`requirements.txt`](https://github.com/microsoft/vscode-python/blob/master/requirements.txt)) |
| 18 | + - [ ] Make sure the "Thanks" section is up-to-date (e.g. compare to versions in [`requirements.txt`](https://github.com/microsoft/vscode-python/blob/main/requirements.txt)) |
19 | 19 | - [ ] Touch up news entries (e.g. add missing periods)
|
20 | 20 | - [ ] Check the Markdown rendering to make sure everything looks good
|
21 | 21 | - [ ] Add any relevant news entries for `debugpy` and the language server if they were updated
|
22 |
| - - [ ] Update [`ThirdPartyNotices-Distribution.txt`](https://github.com/Microsoft/vscode-python/blob/master/ThirdPartyNotices-Distribution.txt) by using https://tools.opensource.microsoft.com/notice (Notes for this process are in the Team OneNote under Python VS Code -> Dev Process -> Third-Party Notices / TPN file) |
23 |
| - - [ ] Update [`ThirdPartyNotices-Repository.txt`](https://github.com/Microsoft/vscode-python/blob/master/ThirdPartyNotices-Repository.txt) as appropriate. This file is manually edited so you can check with the teams if anything needs to be added here. |
24 |
| - - [ ] Create a pull request against `master` (🤖) |
25 |
| - - [ ] Merge pull request into `master` |
| 22 | + - [ ] Update [`ThirdPartyNotices-Distribution.txt`](https://github.com/Microsoft/vscode-python/blob/main/ThirdPartyNotices-Distribution.txt) by using https://tools.opensource.microsoft.com/notice (Notes for this process are in the Team OneNote under Python VS Code -> Dev Process -> Third-Party Notices / TPN file) |
| 23 | + - [ ] Update [`ThirdPartyNotices-Repository.txt`](https://github.com/Microsoft/vscode-python/blob/main/ThirdPartyNotices-Repository.txt) as appropriate. This file is manually edited so you can check with the teams if anything needs to be added here. |
| 24 | + - [ ] Create a pull request against `main` (🤖) |
| 25 | + - [ ] Merge pull request into `main` |
26 | 26 | - [ ] Update the [`release` branch](https://github.com/microsoft/vscode-python/branches)
|
27 | 27 | - [ ] If there are `release` branches that are two versions old (e.g. release-2020.[current month - 2]) you can delete them at this time
|
28 |
| - - [ ] Create a new `release-YYYY.MM` branch from `master` |
29 |
| -- [ ] Update master post-release (🤖) |
30 |
| - - [ ] Bump the version number to the next monthly ("YYYY.MM.0-dev") release in the `master` branch |
| 28 | + - [ ] Create a new `release-YYYY.MM` branch from `main` |
| 29 | +- [ ] Update `main` post-release (🤖) |
| 30 | + - [ ] Bump the version number to the next monthly ("YYYY.MM.0-dev") release in the `main` branch |
31 | 31 | - [ ] `package.json`
|
32 | 32 | - [ ] `package-lock.json`
|
33 |
| - - [ ] Create a pull request against `master` |
34 |
| - - [ ] Merge pull request into `master` |
| 33 | + - [ ] Create a pull request against `main` |
| 34 | + - [ ] Merge pull request into `main` |
35 | 35 | - [ ] Announce the code freeze is over on the same channels
|
36 | 36 | - [ ] Update [Component Governance](https://dev.azure.com/ms/vscode-python/_componentGovernance) (Click on "microsoft/vscode-python" on that page). Notes are in the OneNote under Python VS Code -> Dev Process -> Component Governance.
|
37 | 37 | - [ ] Provide details for any automatically detected npm dependencies
|
|
52 | 52 | - [ ] Make sure the [appropriate pull requests](https://github.com/microsoft/vscode-docs/pulls) for the [documentation](https://code.visualstudio.com/docs/python/python-tutorial) -- including the [WOW](https://code.visualstudio.com/docs/languages/python) page -- are ready
|
53 | 53 | - [ ] Final updates to the `release-YYYY.MM` branch
|
54 | 54 | - [ ] Create a branch against `release-YYYY.MM` for a pull request
|
55 |
| - - [ ] Update the version in [`package.json`](https://github.com/Microsoft/vscode-python/blob/master/package.json) to remove the `-rc` (🤖) |
56 |
| - - [ ] Run `npm install` to make sure [`package-lock.json`](https://github.com/Microsoft/vscode-python/blob/master/package.json) is up-to-date (the only update should be the version number if `package-lock.json` has been kept up-to-date) (🤖) |
57 |
| - - [ ] Update [`CHANGELOG.md`](https://github.com/Microsoft/vscode-python/blob/master/CHANGELOG.md) (🤖) |
| 55 | + - [ ] Update the version in [`package.json`](https://github.com/Microsoft/vscode-python/blob/main/package.json) to remove the `-rc` (🤖) |
| 56 | + - [ ] Run `npm install` to make sure [`package-lock.json`](https://github.com/Microsoft/vscode-python/blob/main/package.json) is up-to-date (the only update should be the version number if `package-lock.json` has been kept up-to-date) (🤖) |
| 57 | + - [ ] Update [`CHANGELOG.md`](https://github.com/Microsoft/vscode-python/blob/main/CHANGELOG.md) (🤖) |
58 | 58 | - [ ] Update version and date for the release section
|
59 |
| - - [ ] Run [`news`](https://github.com/Microsoft/vscode-python/tree/master/news) and copy-and-paste new entries (typically `python news --final | code-insiders -`; quite possibly nothing new to add) |
60 |
| - - [ ] Update [`ThirdPartyNotices-Distribution.txt`](https://github.com/Microsoft/vscode-python/blob/master/ThirdPartyNotices-Distribution.txt) by using https://tools.opensource.microsoft.com/notice (🤖; see team notes) |
61 |
| - - [ ] Update [`ThirdPartyNotices-Repository.txt`](https://github.com/Microsoft/vscode-python/blob/master/ThirdPartyNotices-Repository.txt) manually if necessary |
| 59 | + - [ ] Run [`news`](https://github.com/Microsoft/vscode-python/tree/main/news) and copy-and-paste new entries (typically `python news --final | code-insiders -`; quite possibly nothing new to add) |
| 60 | + - [ ] Update [`ThirdPartyNotices-Distribution.txt`](https://github.com/Microsoft/vscode-python/blob/main/ThirdPartyNotices-Distribution.txt) by using https://tools.opensource.microsoft.com/notice (🤖; see team notes) |
| 61 | + - [ ] Update [`ThirdPartyNotices-Repository.txt`](https://github.com/Microsoft/vscode-python/blob/main/ThirdPartyNotices-Repository.txt) manually if necessary |
62 | 62 | - [ ] Create pull request against `release-YYYY.MM` (🤖)
|
63 | 63 | - [ ] Merge pull request into `release-YYYY.MM`
|
64 | 64 | - [ ] Make sure component governance is happy
|
65 | 65 |
|
66 | 66 | ## Release
|
67 | 67 |
|
68 | 68 | - [ ] Publish the release via Azure DevOps
|
69 |
| - - [ ] Make sure [CI](https://github.com/Microsoft/vscode-python/blob/master/CONTRIBUTING.md) is passing. Try a re-run on any failing CI test stages. If tests still won't pass contact the owning team. |
70 |
| - - [ ] On Azure DevOps on the page for the CI run after it succeeds there will now be a "Releases" tab which is populated with a release entry. Click that entry to go to the release page, which shows the "Upload" and "Publish" stages |
| 69 | + - [ ] Make sure [CI](https://github.com/Microsoft/vscode-python/blob/main/CONTRIBUTING.md) is passing. Try a re-run on any failing CI test stages. If tests still won't pass contact the owning team. |
| 70 | + - [ ] On Azure DevOps on the page for the CI run after it succeeds there will now be a "Releases" tab which is populated with a release entry. Click that entry to go to the release page, which shows the "Upload" and "Publish" stages |
71 | 71 | - [ ] Click the deploy button on the "Upload" stage and make sure that it succeeds
|
72 | 72 | - [ ] Make sure no extraneous files are being included in the `.vsix` file (make sure to check for hidden files)
|
73 | 73 | - [ ] Click the deploy button on the "Publish" stage, this will push out the release to the public
|
|
79 | 79 | - [ ] Publish [documentation changes](https://github.com/Microsoft/vscode-docs/pulls?q=is%3Apr+is%3Aopen+label%3Apython)
|
80 | 80 | - [ ] Publish the [blog](http://aka.ms/pythonblog) post
|
81 | 81 | - [ ] Determine if a hotfix is needed
|
82 |
| -- [ ] Merge `release-YYYY.MM` back into `master`. Don't overwrite the master `-dev` version in package.json. (🤖) |
| 82 | +- [ ] Merge `release-YYYY.MM` back into `main`. Don't overwrite the `-dev` version in package.json. (🤖) |
83 | 83 |
|
84 | 84 | ## Clean up after _this_ release
|
85 | 85 |
|
|
88 | 88 |
|
89 | 89 | ## Prep for the _next_ release
|
90 | 90 |
|
91 |
| -- [ ] Create a new [release plan](https://raw.githubusercontent.com/microsoft/vscode-python/master/.github/release_plan.md) (🤖) |
| 91 | +- [ ] Create a new [release plan](https://raw.githubusercontent.com/microsoft/vscode-python/main/.github/release_plan.md) (🤖) |
92 | 92 | - [ ] [(Un-)pin](https://help.github.com/en/articles/pinning-an-issue-to-your-repository) [release plan issues](https://github.com/Microsoft/vscode-python/labels/release%20plan) (🤖)
|
0 commit comments