From 2e9afd3884415d44cc2997a308ad855870b7e020 Mon Sep 17 00:00:00 2001 From: Lars Francke Date: Tue, 7 Jul 2026 23:51:18 +0200 Subject: [PATCH 1/4] Replace manual CRD docs generation with a Hub verification step The Stackable Hub (hub.stackable.tech/crds) ingests operator CRDs automatically, so the crds.stackable.tech generation step is obsolete. Keep a lightweight checklist item to verify the new release showed up. --- .github/ISSUE_TEMPLATE/06-release.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/06-release.md b/.github/ISSUE_TEMPLATE/06-release.md index 4f2767e..92094d6 100644 --- a/.github/ISSUE_TEMPLATE/06-release.md +++ b/.github/ISSUE_TEMPLATE/06-release.md @@ -132,7 +132,7 @@ assignees: '' > [!TIP] > Name the release-notes branch `docs/release-notes-YY.M.X` so that the link below takes you directly to the [Pull Request template][docs-pr-template]. -- [ ] Generate CRD docs [website][dt-1] for the new release by following these [instructions][dt-2] +- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] (ingestion is automatic, no manual generation needed anymore) - [ ] Create a stackabletech/documentation branch called `docs/release-notes-YY.M.X` - [ ] Compile list of new product features in newly supported versions for the YY.M.X release (for the blog post) - [ ] Begin writing the release notes with the [Pull Request template][dt-3] @@ -145,8 +145,7 @@ assignees: '' - [ ] Update the [getting-started page][dt-6] in the main docs and check it works with this release - [ ] Update release information on the [Stackable Portal][dt-7] to reflect the now current release and history -[dt-1]: https://crds.stackable.tech/ -[dt-2]: https://github.com/stackabletech/crddocs +[dt-1]: https://hub.stackable.tech/crds [dt-3]: https://github.com/stackabletech/documentation/compare/main...docs/release-notes-YY.M.X?template=release-notes.md&title=tracking:%20Release%20Notes%20for%20SDP%20YY.M.X [dt-4]: https://github.com/stackabletech/documentation/blob/main/scripts/make-release-branch.sh [dt-5]: https://github.com/stackabletech/documentation/blob/main/scripts/publish-new-version.sh From 717b7417a4c6261861b6b29d38edad022bbc5479 Mon Sep 17 00:00:00 2001 From: Lars Francke Date: Wed, 8 Jul 2026 00:00:50 +0200 Subject: [PATCH 2/4] Drop the parenthetical about automatic ingestion --- .github/ISSUE_TEMPLATE/06-release.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/06-release.md b/.github/ISSUE_TEMPLATE/06-release.md index 92094d6..e386fcc 100644 --- a/.github/ISSUE_TEMPLATE/06-release.md +++ b/.github/ISSUE_TEMPLATE/06-release.md @@ -132,7 +132,7 @@ assignees: '' > [!TIP] > Name the release-notes branch `docs/release-notes-YY.M.X` so that the link below takes you directly to the [Pull Request template][docs-pr-template]. -- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] (ingestion is automatic, no manual generation needed anymore) +- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] - [ ] Create a stackabletech/documentation branch called `docs/release-notes-YY.M.X` - [ ] Compile list of new product features in newly supported versions for the YY.M.X release (for the blog post) - [ ] Begin writing the release notes with the [Pull Request template][dt-3] From f9daa149d28a0ba03d50065605fdc3bc65d329f0 Mon Sep 17 00:00:00 2001 From: Lars Francke Date: Wed, 8 Jul 2026 00:02:44 +0200 Subject: [PATCH 3/4] Move the Hub verification after the Portal update The Portal is the source of truth for release information; the Hub displays it. Verifying the release on the Hub can only succeed after the Portal has been updated. --- .github/ISSUE_TEMPLATE/06-release.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/06-release.md b/.github/ISSUE_TEMPLATE/06-release.md index e386fcc..89a1aa6 100644 --- a/.github/ISSUE_TEMPLATE/06-release.md +++ b/.github/ISSUE_TEMPLATE/06-release.md @@ -132,7 +132,6 @@ assignees: '' > [!TIP] > Name the release-notes branch `docs/release-notes-YY.M.X` so that the link below takes you directly to the [Pull Request template][docs-pr-template]. -- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] - [ ] Create a stackabletech/documentation branch called `docs/release-notes-YY.M.X` - [ ] Compile list of new product features in newly supported versions for the YY.M.X release (for the blog post) - [ ] Begin writing the release notes with the [Pull Request template][dt-3] @@ -144,6 +143,7 @@ assignees: '' - [ ] Set the release to "Released" in the Feature Tracker and create a new release (ping @lfrancke) - [ ] Update the [getting-started page][dt-6] in the main docs and check it works with this release - [ ] Update release information on the [Stackable Portal][dt-7] to reflect the now current release and history +- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] [dt-1]: https://hub.stackable.tech/crds [dt-3]: https://github.com/stackabletech/documentation/compare/main...docs/release-notes-YY.M.X?template=release-notes.md&title=tracking:%20Release%20Notes%20for%20SDP%20YY.M.X From db906e4984fdbdc3b60fb7310d1607784afdd692 Mon Sep 17 00:00:00 2001 From: Lars Francke Date: Wed, 8 Jul 2026 18:44:34 +0200 Subject: [PATCH 4/4] Renumber dt-N link labels to match usage order --- .github/ISSUE_TEMPLATE/06-release.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/06-release.md b/.github/ISSUE_TEMPLATE/06-release.md index 89a1aa6..7d98493 100644 --- a/.github/ISSUE_TEMPLATE/06-release.md +++ b/.github/ISSUE_TEMPLATE/06-release.md @@ -134,23 +134,23 @@ assignees: '' - [ ] Create a stackabletech/documentation branch called `docs/release-notes-YY.M.X` - [ ] Compile list of new product features in newly supported versions for the YY.M.X release (for the blog post) -- [ ] Begin writing the release notes with the [Pull Request template][dt-3] +- [ ] Begin writing the release notes with the [Pull Request template][dt-1] - [ ] Update SDP release version in `documentation/modules/ROOT/pages/getting-started.adoc` and test the release install command -- [ ] Cut a release branch (see [scripts/make-release-branch.sh][dt-4]) -- [ ] Update releases in the playbook (see [scripts/publish-new-version.sh][dt-5]) +- [ ] Cut a release branch (see [scripts/make-release-branch.sh][dt-2]) +- [ ] Update releases in the playbook (see [scripts/publish-new-version.sh][dt-3]) - [ ] Remove any references to HEAD and main from the Antora playbooks on the release branch (replace with the release branch) - [ ] Update antora.yaml version in stackabletech/demos on the release branch - the stackable-utils release-scripts should do this like they do for products and operators. - [ ] Set the release to "Released" in the Feature Tracker and create a new release (ping @lfrancke) -- [ ] Update the [getting-started page][dt-6] in the main docs and check it works with this release -- [ ] Update release information on the [Stackable Portal][dt-7] to reflect the now current release and history -- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-1] - -[dt-1]: https://hub.stackable.tech/crds -[dt-3]: https://github.com/stackabletech/documentation/compare/main...docs/release-notes-YY.M.X?template=release-notes.md&title=tracking:%20Release%20Notes%20for%20SDP%20YY.M.X -[dt-4]: https://github.com/stackabletech/documentation/blob/main/scripts/make-release-branch.sh -[dt-5]: https://github.com/stackabletech/documentation/blob/main/scripts/publish-new-version.sh -[dt-6]: https://github.com/stackabletech/documentation/blob/main/modules/ROOT/pages/getting-started.adoc -[dt-7]: https://portal.stackable.build/releases +- [ ] Update the [getting-started page][dt-4] in the main docs and check it works with this release +- [ ] Update release information on the [Stackable Portal][dt-5] to reflect the now current release and history +- [ ] Verify the new release and its CRDs show up on the [Stackable Hub][dt-6] + +[dt-1]: https://github.com/stackabletech/documentation/compare/main...docs/release-notes-YY.M.X?template=release-notes.md&title=tracking:%20Release%20Notes%20for%20SDP%20YY.M.X +[dt-2]: https://github.com/stackabletech/documentation/blob/main/scripts/make-release-branch.sh +[dt-3]: https://github.com/stackabletech/documentation/blob/main/scripts/publish-new-version.sh +[dt-4]: https://github.com/stackabletech/documentation/blob/main/modules/ROOT/pages/getting-started.adoc +[dt-5]: https://portal.stackable.build/releases +[dt-6]: https://hub.stackable.tech/crds [docs-pr-template]: https://github.com/stackabletech/documentation/tree/main/.github/PULL_REQUEST_TEMPLATE/release-notes.md&title=tracking:%20Release%20Notes%20for%20SDP%20YY.M.X ## Marketing tasks