From 11251d988e54d4fd6ce872e914e84e3ab3c6e3cb Mon Sep 17 00:00:00 2001 From: Niels Pardon Date: Thu, 15 Jan 2026 10:25:44 +0000 Subject: [PATCH 1/3] docs: add RELEASING.md Signed-off-by: Niels Pardon --- RELEASING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 RELEASING.md diff --git a/RELEASING.md b/RELEASING.md new file mode 100644 index 0000000..11c8423 --- /dev/null +++ b/RELEASING.md @@ -0,0 +1,10 @@ +# Releasing substrait-python + +Given that you are a Substrait committer or PMC member and have the appropriate permissions, releasing a new version of substrait-python is done by simply creating new Github Release through the UI: + +1. Go to https://github.com/substrait-io/substrait-python/releases +2. Click `Draft a new release` +3. Enter the to be released version in the `Tag` field prefixed with a lower case `v`, e.g. `v0.99.0`. Then click `Create new tag` which tells Github to create the tag on publication of the release. +4. Click `Generate release notes` which will automatically populate the release title and release notes fields. +5. If you are happy with the release notes and you are ready for an immediate release simply click `Publish release` otherwise save the release as a draft for later. +6. Monitor the Github Actions release build for the newly created release and tag. From df167bc91e2c557912bef4009c9fb4e20ca450d1 Mon Sep 17 00:00:00 2001 From: Niels Pardon Date: Thu, 15 Jan 2026 16:05:21 +0100 Subject: [PATCH 2/3] docs: apply feedback Co-authored-by: Ben Bellick <36523439+benbellick@users.noreply.github.com> --- RELEASING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASING.md b/RELEASING.md index 11c8423..1721f89 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -4,7 +4,7 @@ Given that you are a Substrait committer or PMC member and have the appropriate 1. Go to https://github.com/substrait-io/substrait-python/releases 2. Click `Draft a new release` -3. Enter the to be released version in the `Tag` field prefixed with a lower case `v`, e.g. `v0.99.0`. Then click `Create new tag` which tells Github to create the tag on publication of the release. +3. Enter the version to be released in the `Tag` field prefixed with a lower case `v`, e.g. `v0.99.0`. Then click `Create new tag` which tells Github to create the tag on publication of the release. 4. Click `Generate release notes` which will automatically populate the release title and release notes fields. 5. If you are happy with the release notes and you are ready for an immediate release simply click `Publish release` otherwise save the release as a draft for later. 6. Monitor the Github Actions release build for the newly created release and tag. From c31e57748f7c10a45dffb588d77cebbd30d9fa79 Mon Sep 17 00:00:00 2001 From: Niels Pardon Date: Thu, 15 Jan 2026 15:09:46 +0000 Subject: [PATCH 3/3] docs: add section about versioning Signed-off-by: Niels Pardon --- RELEASING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/RELEASING.md b/RELEASING.md index 1721f89..300868c 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -8,3 +8,7 @@ Given that you are a Substrait committer or PMC member and have the appropriate 4. Click `Generate release notes` which will automatically populate the release title and release notes fields. 5. If you are happy with the release notes and you are ready for an immediate release simply click `Publish release` otherwise save the release as a draft for later. 6. Monitor the Github Actions release build for the newly created release and tag. + +## Versioning + +substrait-python follows semantic versioning as described for the Substrait specification here: https://substrait.io/spec/versioning/. \ No newline at end of file