docs: RELEASE_CHECKLIST.md update for 0.33 (#10674)
Marcin Rataj committed
Jan 31, 2025 at 17:43 UTC
6927f4fe54b15d17bf61861dc405d85fd7f7201d
1 file changed
+102
-143
docs/RELEASE_CHECKLIST.md
+102
-143
@@ -1,19 +1,16 @@
1
-<!-- Last updated during [v0.32.0 release](https://github.com/ipfs/kubo/issues/10547) -->
1
+<!-- Last updated during [v0.33.0 release](https://github.com/ipfs/kubo/pull/10674) -->
2
3
# ✅ Release Checklist (vX.Y.Z[-rcN])
4
5
## Labels
6
7
-If an item should be executed for a specific release type, it should be labeled with one of the following labels:
7
+If an item should be executed only for a specific release type, it is labeled with:
8
9
-  execute **ONLY** when releasing a Release Candidate
10
--  execute **ONLY** when releasing a Final Release
10
+-  execute **ONLY** when releasing a Final Release
11
+-  do **NOT** execute when releasing a Patch Release
12
12
-Otherwise, it means it should be executed for **ALL** release types.
13
-
14
-Patch releases should follow the same process as `.0` releases. If some item should **NOT** be executed for a Patch Release, it should be labeled with:
15
-
16
--  do **NOT** execute when releasing a Patch Release
13
+Otherwise, it means a step should be executed for **ALL** release types.
14
15
## Before the release
16
@@ -21,158 +18,120 @@ This section covers tasks to be done ahead of the release.
18
19
- [ ] Verify you have access to all the services and tools required for the release
20
- [ ] [GPG signature](https://docs.github.com/en/authentication/managing-commit-signature-verification) configured in local git and in GitHub
24
- - [ ] [admin access to IPFS Discourse](https://discuss.ipfs.tech/g/admins)
25
- - ask the previous release owner (or @2color) for an invite
26
- - [ ]  [access to #shared-pl-marketing-requests](https://filecoinproject.slack.com/archives/C018EJ8LWH1) channel in FIL Slack
27
- - ask the previous release owner for an invite
28
- - [ ] [access to IPFS network metrics](https://github.com/protocol/pldw/blob/624f47cf4ec14ad2cec6adf601a9f7b203ef770d/docs/sources/ipfs.md#ipfs-network-metrics) dashboards in Grafana
29
- - open an access request in the [pldw](https://github.com/protocol/pldw/issues/new/choose)
30
- - [example](https://github.com/protocol/pldw/issues/158)
31
- - [ ] [kuboreleaser](https://github.com/ipfs/kuboreleaser) checked out on your system (_only if you're using [kuboreleaser](https://github.com/ipfs/kuboreleaser)_)
32
- - [ ] [Thunderdome](https://github.com/ipfs-shipyard/thunderdome) checked out on your system and configured (see the [Thunderdome release docs](./releases_thunderdome.md) for setup)
33
- - [ ] [docker](https://docs.docker.com/get-docker/) installed on your system (_only if you're using [kuboreleaser](https://github.com/ipfs/kuboreleaser)_)
34
- - [ ] [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) installed on your system (_only if you're **NOT** using [kuboreleaser](https://github.com/ipfs/kuboreleaser)_)
35
- - [ ] [zsh](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH#install-and-set-up-zsh-as-default) installed on your system
21
+ - [ ] [docker](https://docs.docker.com/get-docker/) installed on your system
22
+ - [ ] [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) installed on your system
23
- [ ] [kubo](https://github.com/ipfs/kubo) checked out under `$(go env GOPATH)/src/github.com/ipfs/kubo`
24
- you can also symlink your clone to the expected location by running `mkdir -p $(go env GOPATH)/src/github.com/ipfs && ln -s $(pwd) $(go env GOPATH)/src/github.com/ipfs/kubo`
38
- - [ ]  [Reddit](https://www.reddit.com) account
39
--  Upgrade Go used in CI to the latest patch release available in [CircleCI](https://hub.docker.com/r/cimg/go/tags) in:
40
- - [ ]  [ipfs/distributions](https://github.com/ipfs/distributions)
41
- - [example](https://github.com/ipfs/distributions/pull/756)
42
- - [ ]  [ipfs/ipfs-docs](https://github.com/ipfs/ipfs-docs)
43
- - [example](https://github.com/ipfs/ipfs-docs/pull/1298)
44
-- [ ] Verify there is nothing [left for release](-what-s-left-for-release)
45
-- [ ] Create a release process improvement PR
46
- - [ ] update the [release issue template](docs/RELEASE_ISSUE_TEMPLATE.md) as you go
47
- - [ ] link it in the [Meta](#meta) section
25
+-  Upgrade Go used in CI to the latest patch release available at <https://go.dev/dl/>
26
27
## The release
28
29
This section covers tasks to be done during each release.
30
53
-- [ ] Prepare the release branch and update version numbers accordingly <details><summary>using `./kuboreleaser --skip-check-before release --version vX.Y.Z(-rcN) prepare-branch` or ...</summary>
31
+### 1. Prepare release branch
32
+
33
+- [ ] Prepare the release branch and update version numbers accordingly
34
- [ ] create a new branch `release-vX.Y.Z`
35
- use `master` as base if `Z == 0`
36
- use `release` as base if `Z > 0`
57
- - [ ]  update the `CurrentVersionNumber` in [version.go](version.go) in the `master` branch to `vX.Y+1.0-dev`
58
- - [example](https://github.com/ipfs/kubo/pull/9305)
59
- - [ ] update the `CurrentVersionNumber` in [version.go](version.go) in the `release-vX.Y` branch to `vX.Y.Z(-rcN)`
60
- - [example](https://github.com/ipfs/kubo/pull/9394)
61
- - [ ] create a draft PR from `release-vX.Y` to `release`
62
- - [example](https://github.com/ipfs/kubo/pull/9306)
63
- - [ ] Cherry-pick commits from `master` to the `release-vX.Y.Z` using `git cherry-pick -x <commit>`
64
- - [ ]  Add full changelog and contributors to the [changelog](docs/changelogs/vX.Y.md)
65
- - [ ]  Replace the `Changelog` and `Contributors` sections of the [changelog](docs/changelogs/vX.Y.md) with the stdout of `./bin/mkreleaselog`. Note that the command expects your `$GOPATH/src/github.com/ipfs/kubo` to include latest commits from `release-vX.Y`
66
- - do **NOT** copy the stderr
67
- - [ ] verify all CI checks on the PR from `release-vX.Y` to `release` are passing
68
- - [ ]  Merge the PR from `release-vX.Y` to `release` using the `Create a merge commit`
37
+ - [ ]  update the `CurrentVersionNumber` in [version.go](version.go) in the `master` branch to `vX.Y+1.0-dev` ([example](https://github.com/ipfs/kubo/pull/9305))
38
+ - [ ] update the `CurrentVersionNumber` in [version.go](version.go) in the `release-vX.Y` branch to `vX.Y.Z(-rcN)` ([example](https://github.com/ipfs/kubo/pull/9394))
39
+ - [ ] create a draft PR from `release-vX.Y.Z` to `release` ([example](https://github.com/ipfs/kubo/pull/9306))
40
+ - [ ] Cherry-pick commits from `master` to the `release-vX.Y.Z` using `git cherry-pick -x <commit>` ([example](https://github.com/ipfs/kubo/pull/10636/commits/033de22e3bc6191dbb024ad6472f5b96b34e3ccf))
41
+ - **NOTE:** cherry-picking with `-x` is important
42
+ - [ ]  Replace the `Changelog` and `Contributors` sections of the [changelog](docs/changelogs/vX.Y.md) with the stdout (do **NOT** copy the stderr) of `./bin/mkreleaselog`.
43
+ - **NOTE:** `mkreleaselog` expects your `$GOPATH/src/github.com/ipfs/kubo` to include latest commits from `release-vX.Y.Z`
44
+ - [ ] verify all CI checks on the PR from `release-vX.Y.Z` to `release` are passing
45
+ - [ ]  Merge the PR from `release-vX.Y.Z` to `release` using the `Create a merge commit`
46
- do **NOT** use `Squash and merge` nor `Rebase and merge` because we need to be able to sign the merge commit
70
- - do **NOT** delete the `release-vX.Y` branch
71
- </details>
72
-- [ ] Create the release tag <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) tag` or ...</summary>
73
- - This is a dangerous operation! Go and Docker publishing are difficult to reverse! Have the release reviewer verify all the commands marked with ⚠️!
74
- - [ ] ⚠️  tag the HEAD commit using `git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'`
75
- - [ ] ⚠️  tag the HEAD commit of the `release` branch using `git tag -s vX.Y.Z -m 'Release X.Y.Z'`
76
- - [ ] ⚠️ verify the tag is signed and tied to the correct commit using `git show vX.Y.Z(-rcN)`
77
- - [ ] ⚠️ push the tag to GitHub using `git push origin vX.Y.Z(-rcN)`
78
- - do **NOT** use `git push --tags` because it pushes all your local tags
79
- </details>
80
-- [ ] Verify [ipfs/distributions](https://github.com/ipfs/distributions)'s `.tool-versions`'s `golang` entry is set to the [latest go release](https://go.dev/doc/devel/release) on the major go branch [Kubo is being tested on](https://github.com/ipfs/kubo/blob/master/.github/workflows/gotest.yml) (see `go-version:`).
81
-- [ ] Publish to Dockerhub, NPM, and dist.ipfs.tech and GitHub using `./kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-all` or follow each step below:
82
- - [ ] Publish the release to [DockerHub](https://hub.docker.com/r/ipfs/kubo/) <details><summary>using `./kuboreleaser --skip-check-before --skip-run release --version vX.Y.Z(-rcN) publish-to-dockerhub` or ...</summary>
83
- - [ ] Wait for [Publish docker image](https://github.com/ipfs/kubo/actions/workflows/docker-image.yml) workflow run initiated by the tag push to finish
84
- - [ ] verify the image is available on [Docker Hub](https://hub.docker.com/r/ipfs/kubo/tags)
85
- - [ ] Publish the release to [dist.ipfs.tech](https://dist.ipfs.tech) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-distributions` or ...</summary>
86
- - [ ] check out [ipfs/distributions](https://github.com/ipfs/distributions)
87
- - [ ] create new branch: run `git checkout -b release-kubo-X.Y.Z(-rcN)`
88
- - [ ] run `./dist.sh add-version kubo vX.Y.Z(-rcN)` to add the new version to the `versions` file
89
- - [usage](https://github.com/ipfs/distributions#usage)
90
- - [ ] create and merge the PR which updates `dists/kubo/versions` and `dists/go-ipfs/versions` ( and `dists/kubo/current` and `dists/go-ipfs/current`)
91
- - [example](https://github.com/ipfs/distributions/pull/760)
92
- - [ ] wait for the [CI](https://github.com/ipfs/distributions/actions/workflows/main.yml) workflow run initiated by the merge to master to finish
93
- - [ ] verify the release is available on [dist.ipfs.tech](https://dist.ipfs.tech/#kubo)
94
- </details>
95
- - [ ] Publish the release to [NPM](https://www.npmjs.com/package/kubo?activeTab=versions) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-npm` (⚠️ you might need to run the command a couple of times because GHA might not be able to see the new distribution straight away due to caching) or ...</summary>
96
- - [ ] run the [Release to npm](https://github.com/ipfs/npm-go-ipfs/actions/workflows/main.yml) workflow
97
- - [ ] check [Release to npm](https://github.com/ipfs/npm-go-ipfs/actions/workflows/main.yml) workflow run logs to verify it discovered the new release
98
- - [ ] verify the release is available on [NPM](https://www.npmjs.com/package/kubo?activeTab=versions)
99
- </details>
100
- - [ ] Publish the release to [GitHub](https://github.com/ipfs/kubo/releases) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) publish-to-github` or ...</summary>
101
- - [ ] create a new release on [GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release)
102
- - [RC example](https://github.com/ipfs/kubo/releases/tag/v0.17.0-rc1)
103
- - [FINAL example](https://github.com/ipfs/kubo/releases/tag/v0.17.0)
104
- - [ ] use the `vX.Y.Z(-rcN)` tag
105
- - [ ] link to the release issue
106
- - [ ]  link to the changelog in the description
107
- - [ ]  check the `This is a pre-release` checkbox
108
- - [ ]  copy the changelog (without the header) in the description
109
- - [ ]  do **NOT** check the `This is a pre-release` checkbox
110
- - [ ] run the [sync-release-assets](https://github.com/ipfs/kubo/actions/workflows/sync-release-assets.yml) workflow
111
- - [ ] wait for the [sync-release-assets](https://github.com/ipfs/kubo/actions/workflows/sync-release-assets.yml) workflow run to finish
112
- - [ ] verify the release assets are present in the [GitHub release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN))
113
- </details>
47
+ - do **NOT** delete the `release-vX.Y.Z` branch
48
+
49
+### 2. Tag release
50
+
51
+- [ ] Create the release tag
52
+ - ⚠️ **NOTE:** This is a dangerous operation! Go and Docker publishing are difficult to reverse! Have the release reviewer verify all the commands marked with !
53
+ - [ ]  tag the HEAD commit using `git tag -s vX.Y.Z(-rcN) -m 'Prerelease X.Y.Z(-rcN)'`
54
+ - [ ]  tag the HEAD commit of the `release` branch using `git tag -s vX.Y.Z -m 'Release X.Y.Z'`
55
+ - [ ] ⚠️ verify the tag is signed and tied to the correct commit using `git show vX.Y.Z(-rcN)`
56
+ - [ ] push the tag to GitHub using `git push origin vX.Y.Z(-rcN)`
57
+ - ⚠️ do **NOT** use `git push --tags` because it pushes all your local tags
58
+
59
+### 3. Publish
60
+
61
+- [ ] Publish Docker image to [DockerHub](https://hub.docker.com/r/ipfs/kubo/tags)
62
+ - [ ] Wait for [Publish docker image](https://github.com/ipfs/kubo/actions/workflows/docker-image.yml) workflow run initiated by the tag push to finish
63
+ - [ ] verify the image is available on [Docker Hub → tags](https://hub.docker.com/r/ipfs/kubo/tags)
64
+- [ ] Publish the release to [dist.ipfs.tech](https://dist.ipfs.tech)
65
+ - [ ] check out [ipfs/distributions](https://github.com/ipfs/distributions)
66
+ - [ ] create new branch: run `git checkout -b release-kubo-X.Y.Z(-rcN)`
67
+ - [ ] run `./dist.sh add-version kubo vX.Y.Z(-rcN)` to add the new version to the `versions` file ([usage](https://github.com/ipfs/distributions#usage))
68
+ - [ ] Verify [ipfs/distributions](https://github.com/ipfs/distributions)'s `.tool-versions`'s `golang` entry is set to the [latest go release](https://go.dev/doc/devel/release) on the major go branch [Kubo is being tested on](https://github.com/ipfs/kubo/blob/master/.github/workflows/gotest.yml) (see `go-version:`). If not, update `.tool-versions` to match the latest golang.
69
+ - [ ] create and merge the PR which updates `dists/kubo/versions` and `dists/go-ipfs/versions` (**NOTE:**  will also have `dists/kubo/current` and `dists/go-ipfs/current` – [example](https://github.com/ipfs/distributions/pull/1125))
70
+ - [ ] wait for the [CI](https://github.com/ipfs/distributions/actions/workflows/main.yml) workflow run initiated by the merge to master to finish
71
+ - [ ] verify the release is available on [dist.ipfs.tech](https://dist.ipfs.tech/#kubo)
72
+- [ ] Publish the release to [NPM](https://www.npmjs.com/package/kubo?activeTab=versions)
73
+ - [ ] manually dispatch the [Release to npm](https://github.com/ipfs/npm-go-ipfs/actions/workflows/main.yml) workflow
74
+ - [ ] check [Release to npm](https://github.com/ipfs/npm-go-ipfs/actions/workflows/main.yml) workflow run logs to verify it discovered the new release
75
+ - [ ] verify the release is available on [NPM](https://www.npmjs.com/package/kubo?activeTab=versions)
76
+- [ ] Publish the release to [GitHub kubo/releases](https://github.com/ipfs/kubo/releases)
77
+ - [ ] create a new release on [github.com/ipfs/kubo/releases](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release)
78
+ - [RC example](https://github.com/ipfs/kubo/releases/tag/v0.17.0-rc1)
79
+ - [FINAL example](https://github.com/ipfs/kubo/releases/tag/v0.17.0)
80
+ - [ ] use the `vX.Y.Z(-rcN)` tag
81
+ - [ ] link to the release issue
82
+ - [ ]  link to the changelog in the description
83
+ - [ ]  check the `This is a pre-release` checkbox
84
+ - [ ]  copy the changelog (without the header) in the description
85
+ - [ ]  do **NOT** check the `This is a pre-release` checkbox
86
+ - [ ] run the [sync-release-assets](https://github.com/ipfs/kubo/actions/workflows/sync-release-assets.yml) workflow
87
+ - [ ] wait for the [sync-release-assets](https://github.com/ipfs/kubo/actions/workflows/sync-release-assets.yml) workflow run to finish
88
+ - [ ] verify the release assets are present in the [GitHub release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN))
89
+
90
+### 4. After Publishing
91
+
92
+- [ ]  Merge the [release](https://github.com/ipfs/kubo/tree/release) branch back into [master](https://github.com/ipfs/kubo/tree/master)
93
+ - [ ] Create a new branch `merge-release-vX.Y.Z` from `release`
94
+ - [ ] Create the next [`./docs/changelogs/vA.B.md`](https://github.com/ipfs/kubo/blob/master/docs/changelogs/) and link to the new changelog from the [`./CHANGELOG.md`](https://github.com/ipfs/kubo/blob/master/CHANGELOG.md) file
95
+ - [ ] Create and merge a PR from `merge-release-vX.Y.Z` to `master`
96
+ - ⚠️ do **NOT** use `Squash and merge` nor `Rebase and merge` because we need to be able to sign the merge commit
97
+ - ⚠️ **NOTE:** make sure to ignore the changes to [version.go](version.go) (keep the `-dev` in `master`)
98
- [ ] Update Kubo staging environment, see the [Running Kubo tests on staging](https://www.notion.so/Running-Kubo-tests-on-staging-488578bb46154f9bad982e4205621af8) for details.
99
- [ ]  Test last release against the current RC
116
- - [ ]  Test last release against the current one
117
-- [ ] Promote the release <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) promote` or ...</summary>
118
- - [ ] create an [IPFS Discourse](https://discuss.ipfs.tech) topic
119
- - [prerelease example](https://discuss.ipfs.tech/t/kubo-v0-16-0-rc1-release-candidate-is-out/15248)
120
- - [release example](https://discuss.ipfs.tech/t/kubo-v0-16-0-release-is-out/15249)
121
- - [ ] use `Kubo vX.Y.Z(-rcN) is out!` as the title
122
- - [ ] use `kubo` and `go-ipfs` as topics
100
+ - [ ]  Test last release against the current one
101
+- [ ] Promote the release
102
+ - [ ] create an [IPFS Discourse](https://discuss.ipfs.tech) topic ([prerelease example](https://discuss.ipfs.tech/t/kubo-v0-16-0-rc1-release-candidate-is-out/15248), [release example](https://discuss.ipfs.tech/t/kubo-v0-16-0-release-is-out/15249))
103
+ - [ ] use `Kubo vX.Y.Z(-rcN) is out!` as the title and `kubo` and `go-ipfs` as tags
104
- [ ] repeat the title as a heading (`##`) in the description
105
- [ ] link to the GitHub Release, binaries on IPNS, docker pull command and release notes in the description
125
- - [ ] pin the [IPFS Discourse](https://discuss.ipfs.tech) topic globally
126
- - you can make the topic a banner if there is no banner already
127
- - verify the [IPFS Discourse](https://discuss.ipfs.tech) topic was copied to:
106
+ - [ ] pin the [IPFS Discourse](https://discuss.ipfs.tech) topic globally, you can make the topic a banner if there is no banner already
107
+ - [ ] verify the [IPFS Discourse](https://discuss.ipfs.tech) topic was copied to:
108
- [ ] [#ipfs-chatter](https://discord.com/channels/669268347736686612/669268347736686615) in IPFS Discord
109
- [ ] [#ipfs-chatter](https://filecoinproject.slack.com/archives/C018EJ8LWH1) in FIL Slack
110
- [ ] [#ipfs-chatter:ipfs.io](https://matrix.to/#/#ipfs-chatter:ipfs.io) in Matrix
131
- - [ ]  Add the link to the [IPFS Discourse](https://discuss.ipfs.tech) topic to the [GitHub Release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN)) description
132
- - [example](https://github.com/ipfs/kubo/releases/tag/v0.17.0)
133
- - [ ]  create an issue comment mentioning early testers on the release issue
134
- - [example](https://github.com/ipfs/kubo/issues/9319#issuecomment-1311002478)
135
- - [ ]  create an issue comment linking to the release on the release issue
136
- - [example](https://github.com/ipfs/kubo/issues/9417#issuecomment-1400740975)
137
- - [ ]   ask the marketing team to tweet about the release in [#shared-pl-marketing-requests](https://filecoinproject.slack.com/archives/C018EJ8LWH1) in FIL Slack
138
- - [example](https://filecoinproject.slack.com/archives/C018EJ8LWH1/p1664885305374900)
139
- - [ ]   post the link to the [GitHub Release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN)) to [Reddit](https://reddit.com/r/ipfs)
140
- - [example](https://www.reddit.com/r/ipfs/comments/9x0q0k/kubo_v0160_release_is_out/)
141
- </details>
142
-- [ ] ~~Test the new version with `ipfs-companion`~~ ([currently skipped](https://github.com/ipfs/ipfs-companion/issues/1300)) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) test-ipfs-companion` or ...</summary>
143
- - [ ] run the [e2e](https://github.com/ipfs/ipfs-companion/actions/workflows/e2e.yml)
144
- - use `vX.Y.Z(-rcN)` as the Kubo image version
145
- - [ ] wait for the [e2e](https://github.com/ipfs/ipfs-companion/actions/workflows/e2e.yml) workflow run to finish
146
- </details>
147
-- [ ]  Update Kubo in [ipfs-desktop](https://github.com/ipfs/ipfs-desktop) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-desktop` or ...</summary>
111
+ - [ ]  Add the link to the [IPFS Discourse](https://discuss.ipfs.tech) topic to the [GitHub Release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN)) description ([example](https://github.com/ipfs/kubo/releases/tag/v0.17.0))
112
+ - [ ]  create an issue comment mentioning early testers on the release issue ([example](https://github.com/ipfs/kubo/issues/9319#issuecomment-1311002478))
113
+ - [ ]  create an issue comment linking to the release on the release issue ([example](https://github.com/ipfs/kubo/issues/9417#issuecomment-1400740975))
114
+ - [ ]   promote on bsky.app ([example](https://bsky.app/profile/ipshipyard.com/post/3lh2brzrwbs2c))
115
+ - [ ]   promote on x.com ([example](https://x.com/ipshipyard/status/1885346348808929609))
116
+ - [ ]   post the link to the [GitHub Release](https://github.com/ipfs/kubo/releases/tag/vX.Y.Z(-rcN)) to [Reddit](https://reddit.com/r/ipfs) ([example](https://www.reddit.com/r/ipfs/comments/9x0q0k/kubo_v0160_release_is_out/))
117
+- [ ] Manually smoke-test the new version with [IPFS Companion Browser Extension](https://docs.ipfs.tech/install/ipfs-companion/)
118
+- [ ]  Update Kubo in [ipfs-desktop](https://github.com/ipfs/ipfs-desktop)
119
- [ ] check out [ipfs/ipfs-desktop](https://github.com/ipfs/ipfs-desktop)
149
- - [ ] run `npm install`
150
- - [ ] create a PR which updates `package.json` and `package-lock.json`
151
- - [ ]  add @SgtPooki as reviewer
152
- </details>
153
-- [ ]  Update Kubo docs <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-docs` or ...</summary>
154
- - [ ]  run the [update-on-new-ipfs-tag.yml](https://github.com/ipfs/ipfs-docs/actions/workflows/update-on-new-ipfs-tag.yml) workflow
155
- - [ ]  merge the PR created by the [update-on-new-ipfs-tag.yml](https://github.com/ipfs/ipfs-docs/actions/workflows/update-on-new-ipfs-tag.yml) workflow run
156
- </details>
157
-- [ ]  Create a blog entry on [blog.ipfs.tech](https://blog.ipfs.tech) <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) update-ipfs-blog --date YYYY-MM-DD` or ...</summary>
158
- - [ ]  create a PR which adds a release note for the new Kubo version
159
- - [example](https://github.com/ipfs/ipfs-blog/pull/529)
160
- - [ ]  merge the PR
161
- - [ ]  verify the blog entry was published
162
- </details>
163
-- [ ]  Merge the [release](https://github.com/ipfs/kubo/tree/release) branch back into [master](https://github.com/ipfs/kubo/tree/master), ignoring the changes to [version.go](version.go) (keep the `-dev`) version, <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) merge-branch` or ...</summary>
164
- - [ ] create a new branch `merge-release-vX.Y.Z` from `release`
165
- - [ ] create and merge a PR from `merge-release-vX.Y.Z` to `master`
166
- </details>
167
-- [ ]   Prepare for the next release <details><summary>using `./kuboreleaser release --version vX.Y.Z(-rcN) prepare-next` or ...</summary>
168
- - [ ]   Create the next [changelog](https://github.com/ipfs/kubo/blob/master/docs/changelogs/vX.(Y+1).md)
169
- - [ ]   Link to the new changelog in the [CHANGELOG.md](CHANGELOG.md) file
170
- - [ ]   Create the next release issue
120
+ - [ ] run `npm install `
121
+ - [ ] create a PR which updates `package.json` and `package-lock.json`
122
+- [ ]  Update Kubo docs at docs.ipfs.tech:
123
+ - [ ]  run the [update-on-new-ipfs-tag.yml](https://github.com/ipfs/ipfs-docs/actions/workflows/update-on-new-ipfs-tag.yml) workflow
124
+ - [ ]  merge the PR created by the [update-on-new-ipfs-tag.yml](https://github.com/ipfs/ipfs-docs/actions/workflows/update-on-new-ipfs-tag.yml) workflow run
125
</details>
172
-- [ ]   Create a dependency update PR
173
- - [ ]   check out [ipfs/kubo](https://github.com/ipfs/kubo)
174
- - [ ]   go over direct dependencies from `go.mod` in the root directory (NOTE: do not run `go get -u` as it will upgrade indirect dependencies which may cause problems)
175
- - [ ]   run `make mod_tidy`
176
- - [ ]   create a PR which updates `go.mod` and `go.sum`
177
- - [ ]   add the PR to the next release milestone
178
-- [ ]  Close the release issue
126
+- [ ]  Create a blog entry on [blog.ipfs.tech](https://blog.ipfs.tech)
127
+ - [ ]  create a PR which adds a release note for the new Kubo version ([example](https://github.com/ipfs/ipfs-blog/pull/529))
128
+ - [ ]  merge the PR
129
+ - [ ]  verify the blog entry was published
130
+- [ ]   Create a dependency update PR
131
+ - [ ]   check out [ipfs/kubo](https://github.com/ipfs/kubo)
132
+ - [ ]   go over direct dependencies from `go.mod` in the root directory (NOTE: do not run `go get -u` as it will upgrade indirect dependencies which may cause problems)
133
+ - [ ]   run `make mod_tidy`
134
+ - [ ]   create a PR which updates `go.mod` and `go.sum`
135
+ - [ ]   add the PR to the next release milestone
136
+- [ ]   Create the next release issue
137
+- [ ]  Close the release issue