You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/maintainers_guide.md
+16-12Lines changed: 16 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -147,15 +147,17 @@ Before creating a new release, ensure that everything on a stable branch has
147
147
landed, then [run the tests](#run-all-the-unit-tests).
148
148
149
149
1. Create the commit for the release
150
-
1. In `slack_bolt/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and [Developmental Release](https://peps.python.org/pep-0440/#developmental-releases).
150
+
1. Use the latest supported Python version. Using a [virtual environment](#python-and-friends) is recommended.
151
+
2. In `slack_bolt/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and [Developmental Release](https://peps.python.org/pep-0440/#developmental-releases).
151
152
- Example: if the current version is `1.2.3`, a proper development bump would be `1.2.4.dev0`
152
153
- `.dev` will indicate to pip that this is a [Development Release](https://peps.python.org/pep-0440/#developmental-releases)
153
154
- Note that the `dev` version can be bumped in development releases: `1.2.4.dev0` ->`1.2.4.dev1`
154
-
2. Build the docs with `./scripts/generate_api_docs.sh`.
155
-
3. Commit with a message including the new version number. For example `1.2.4.dev0`& push the commit to a branch where the development release will live (create it if it does not exist)
155
+
3. Build the docs with `./scripts/generate_api_docs.sh`.
156
+
4. Commit with a message including the new version number. For example `1.2.4.dev0`& push the commit to a branch where the development release will live (create it if it does not exist)
156
157
1. `git checkout -b future-release`
157
-
2. `git commit -m 'chore(release): version 1.2.4.dev0'`
158
-
3. `git push -u origin future-release`
158
+
2. `git add --all` (review files with `git status` before committing)
159
+
3. `git commit -m 'chore(release): version 1.2.4.dev0'`
160
+
4. `git push -u origin future-release`
159
161
2. Create a new GitHub Release
160
162
1. Navigate to the [Releases page](https://github.com/slackapi/bolt-python/releases).
161
163
2. Click the "Draft a new release" button.
@@ -179,14 +181,16 @@ Before creating a new release, ensure that everything on the `main` branch since
179
181
the last tag is in a releasable state! At a minimum, [run the tests](#run-all-the-unit-tests).
180
182
181
183
1. Create the commit for the release
182
-
1. In `slack_bolt/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and the [Versioning](#versioning-and-tags) section.
183
-
2. Build the docs with `./scripts/generate_api_docs.sh`.
184
-
3. Commit with a message including the new version number. For example `1.2.3` & push the commit to a branch and create a PR to sanity check.
184
+
1. Use the latest supported Python version. Using a [virtual environment](#python-and-friends) is recommended.
185
+
2. In `slack_bolt/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and the [Versioning](#versioning-and-tags) section.
186
+
3. Build the docs with `./scripts/generate_api_docs.sh`.
187
+
4. Commit with a message including the new version number. For example `1.2.3` & push the commit to a branch and create a PR to sanity check.
185
188
1. `git checkout -b 1.2.3-release`
186
-
2. `git commit -m 'chore(release): version 1.2.3'`
187
-
3. `git push -u origin 1.2.3-release`
188
-
4. Add relevant labels to the PR and add the PR to a GitHub Milestone.
189
-
5. Merge in release PR after getting an approval from at least one maintainer.
189
+
2. `git add --all` (review files with `git status` before committing)
190
+
3. `git commit -m 'chore(release): version 1.2.3'`
191
+
4. `git push -u origin 1.2.3-release`
192
+
5. Add relevant labels to the PR and add the PR to a GitHub Milestone.
193
+
6. Merge in release PR after getting an approval from at least one maintainer.
190
194
2. Create a new GitHub Release
191
195
1. Navigate to the [Releases page](https://github.com/slackapi/bolt-python/releases).
0 commit comments