From f341e60b388bc682d3cf6fc50aa8aae2e9f4e27f Mon Sep 17 00:00:00 2001 From: Ben Browning Date: Tue, 10 Dec 2024 09:16:49 -0500 Subject: [PATCH] Document updating of CHANGELOG.md as part of release Signed-off-by: Ben Browning --- .spellcheck-en-custom.txt | 5 ++++- docs/release-strategy.md | 8 +++++++- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/.spellcheck-en-custom.txt b/.spellcheck-en-custom.txt index eb773134..f15f5887 100644 --- a/.spellcheck-en-custom.txt +++ b/.spellcheck-en-custom.txt @@ -3,10 +3,12 @@ # SPDX-License-Identifier: Apache-2.0 Backport backported +backporting +CHANGELOG CLI codebase -composable Composable +composable config configs customizable @@ -30,6 +32,7 @@ Langchain's LLM LLMBlock MCQ +md Merlinite Mixtral MMLU diff --git a/docs/release-strategy.md b/docs/release-strategy.md index b201ffb6..fce18ab1 100644 --- a/docs/release-strategy.md +++ b/docs/release-strategy.md @@ -43,10 +43,14 @@ Release mechanics are done by a Release Manager identified for that release. The Release Manager is a member of the SDG Maintainers team that has agreed to take on these responsibilities. The Release Manager can change on a per-release basis. -The following are the steps for how Y-stream and Z-stream releases gets cut. +### Prepare CHANGELOG.md for the release + +In the `main` branch, move the appropriate unreleased items in the top level CHANGELOG.md to a section for the new release. And, audit commits in the release and add notes for any missed items. Ensure any changes to CHANGELOG.md also end up on the appropriate release branch, which may involve backporting changes as necessary. ### Y-Stream +Follow these steps when creating a new Y-stream release: + 1. Determine a commit on the main branch that will serve as the basis for the next release - most of the time this should be the latest commit. 1. Create a new release branch in the format `release-vX.Y` off of the determined commit (will match `main` if the latest commit is chosen). 1. Create a new release on GitHub targeting the release branch and using the latest Y-Stream tag as the previous release (e.g. `0.15.1` precedes `0.16.0`). @@ -57,6 +61,8 @@ The following are the steps for how Y-stream and Z-stream releases gets cut. ### Z-Stream +Follow these steps when creating a new Z-stream release: + 1. Backport all relevant commits from `main` to the `release-vX.Y` branch. - It may also be the case you wish to update release branch first - if this approach is taken, ensure any relevant commits are subsequently backported to `main` 1. Create a new release on GitHub targeting the release branch and using the previous Z-Stream tag as the previous release (e.g. `0.15.0` precedes `0.15.1`).