Skip to content

Commit 179b32d

Browse files
committed
Update release process.
Signed-off-by: Andre Pradhana <[email protected]>
1 parent a00a61a commit 179b32d

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

tsc/process/release.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,32 @@
11
# Release Process for OpenVDB
22

3-
The following assumes that the current OpenVDB library version number is 6.0.0 and the new version number is 6.1.0. Adjust for the actual version numbers as appropriate. The release process is typically performed from a "release candidate" GitHub branch. This is to allow other PRs to be merged while the release process is underway.
3+
The following assumes that the current OpenVDB library version number is 10.0.0 and the new version number is 10.1.0. Adjust for the actual version numbers as appropriate. The release process is typically performed from a "release candidate" GitHub branch. This is to allow other PRs to be merged while the release process is underway.
44

55
## Performing the release
66

7-
1. Create a new release candidate branch such as `v6.1.0_rc` using the branch selector on [GitHub](https://www.google.com/search?q=github+creating+branches+within+your+repository) when the release is imminent.
7+
1. Create a new release candidate branch such as `v10.1.0_rc` using the branch selector on [GitHub](https://www.google.com/search?q=github+creating+branches+within+your+repository) when the release is imminent.
88
2. Click the "Draft a new release" button under the [GitHub releases](https://github.com/AcademySoftwareFoundation/openvdb/releases) page.
9-
* 2a. Create a new `v6.1.0` tag under the "Choose a tag" drop-down (Note that this tag will not be created until the release is published).
10-
* 2b. Select `v6.1.0_rc` under the "Target" drop-down.
11-
* 2c. Set "OpenVDB 6.1.0" as the title.
12-
* 2d. As a minimum, the body should be "See the [release notes](https://www.openvdb.org/documentation/doxygen/changes.html#v6_1_0_changes) for more details.". Include the correct link to the documentation. (Note this link will be broken until the documentation is generated in step 8). It is optional to also include a few release highlights.
9+
* 2a. Create a new `v10.1.0` tag under the "Choose a tag" drop-down (Note that this tag will not be created until the release is published).
10+
* 2b. Select `v10.1.0_rc` under the "Target" drop-down.
11+
* 2c. Set "OpenVDB 10.1.0" as the title.
12+
* 2d. As a minimum, the body should be "See the [release notes](https://www.openvdb.org/documentation/doxygen/changes.html#v10.1.0_changes) for more details.". Include the correct link to the documentation. (Note this link will be broken until the documentation is generated in step 8). It is optional to also include a few release highlights.
1313
* 2e. Click the "Save draft" button. DO NOT publish the release at this stage.
14-
3. Check out the `v6.1.0_rc` branch.
14+
3. Check out the `v10.1.0_rc` branch.
1515
4. Ensure the root `CMakeLists.txt` has the correct version number at the top.
16-
5. Update `CHANGES` and `doc/changes.txt` with release notes. Include any outstanding changes from the /pendingchanges directory.
17-
6. Update the "Version 6.1.0 - In development" section in `CHANGES` and `doc/changes.txt` to replace "In development" with the planned release date.
18-
7. Merge these changes to `v6.1.0_rc` in a new pull request and verify that the build CI runs successfully.
19-
8. Manually dispatch the weekly CI workflow from the `v6.1.0_rc` branch and verify that the additional checks run successfully.
20-
9. Go to the [GitHub docs actions](https://github.com/AcademySoftwareFoundation/openvdb/actions/workflows/docs.yml?query=workflow%3ADocs) for OpenVDB and manually dispatch the workflow for the `v6.1.0_rc` branch and set deploy to "docs". This will generate and add the documentation to the [OpenVDB website](https://github.com/AcademySoftwareFoundation/openvdb-website) repo and typically takes around 15 mins. When the action completes, check over the documentation on the `master` branch in the [OpenVDB website](https://github.com/AcademySoftwareFoundation/openvdb-website) repo. Fix any errors through pull request and re-dispatch the workflow if necessary.
16+
5. Update `CHANGES` and `doc/changes.txt` with release notes. Include any outstanding changes from the /pendingchanges directory. Run it through a spell-check tool.
17+
6. Update the "Version 10.1.0 - In development" section in `CHANGES` and `doc/changes.txt` to replace "In development" with the planned release date.
18+
7. Merge these changes to `v10.1.0_rc` in a new pull request and verify that the build CI runs successfully.
19+
8. Manually dispatch the weekly CI workflow from the `v10.1.0_rc` branch and verify that the additional checks run successfully.
20+
9. Go to the [GitHub docs actions](https://github.com/AcademySoftwareFoundation/openvdb/actions/workflows/docs.yml?query=workflow%3ADocs) for OpenVDB and manually dispatch the workflow for the `v10.1.0_rc` branch and set deploy to "docs". This will generate and add the documentation to the [OpenVDB website](https://github.com/AcademySoftwareFoundation/openvdb-website) repo and typically takes around 15 mins. When the action completes, check over the documentation on the `master` branch in the [OpenVDB website](https://github.com/AcademySoftwareFoundation/openvdb-website) repo. Fix any errors through pull request and re-dispatch the workflow if necessary.
2121
10. Publish the GitHub draft release from the [GitHub releases](https://github.com/AcademySoftwareFoundation/openvdb/releases) page.
22-
11. Merge the `v6.1.0_rc` branch back into `master` in a new pull request to ensure edits to release notes or any other fixes go back to master.
23-
12. Delete the `v6.1.0_rc` branch.
22+
11. Merge the `v10.1.0_rc` branch back into `master` in a new pull request to ensure edits to release notes or any other fixes go back to master.
23+
12. Delete the `v10.1.0_rc` branch.
2424

2525
## Updating master for the subsequent release
2626

2727
13. Fetch the latest changes in your local repository and check out the `master` branch.
28-
14. Change one or more of `OpenVDB_MAJOR_VERSION`, `OpenVDB_MINOR_VERSION` and `OpenVDB_PATCH_VERSION` in the root `CMakeLists.txt`. Unless it is known that the next release will include API- or ABI-breaking changes, increment only the patch number to begin with (in this case, from 6.1.0 to 6.1.1).
29-
15. Add a "Version 6.1.1 - In development" section to `CHANGES` and to `doc/changes.txt`.
28+
14. Change one or more of `OpenVDB_MAJOR_VERSION`, `OpenVDB_MINOR_VERSION` and `OpenVDB_PATCH_VERSION` in the root `CMakeLists.txt`. Unless it is known that the next release will include API- or ABI-breaking changes, increment only the patch number to begin with (in this case, from 10.1.0 to 10.1.1).
29+
15. Add a "Version 10.1.1 - In development" section to `CHANGES` and to `doc/changes.txt`.
3030
16. Merge these changes to `master` in a new pull request.
3131

3232
## Announcing the release

0 commit comments

Comments
 (0)