diff --git a/blog/2025-09-09-path-to-helm-v4.md b/blog/2025-09-09-path-to-helm-v4.md index 09513913ff..869dc5365b 100644 --- a/blog/2025-09-09-path-to-helm-v4.md +++ b/blog/2025-09-09-path-to-helm-v4.md @@ -23,7 +23,7 @@ The beta period starts in October. At this point the focus is on stability in pr Testers should file bugs as they encounter any issues. -Per [release schedule policy](https://helm.sh/docs/topics/release_policy/#major-releases), once the first beta version is available, the final 4.0.0 release date will be chosen and announced. +Per [release schedule policy](/community/release_policy#major-releases), once the first beta version is available, the final 4.0.0 release date will be chosen and announced. ## Release Candidates diff --git a/community/release_checklist.md b/community/release_checklist.md index 016f873e38..8724bf7627 100644 --- a/community/release_checklist.md +++ b/community/release_checklist.md @@ -1,7 +1,6 @@ --- title: Maintainer Release Checklist description: Checklist for maintainers when releasing the next version of Helm. -sidebar_position: 3 --- # A Maintainer's Guide to Releasing Helm diff --git a/docs/topics/release_policy.md b/community/release_policy.md similarity index 93% rename from docs/topics/release_policy.md rename to community/release_policy.md index 3d5dcc4563..43cbb20a32 100644 --- a/docs/topics/release_policy.md +++ b/community/release_policy.md @@ -26,10 +26,11 @@ done once a month on the second Wednesday of each month. A patch release to fix a high priority regression or security issue can be done whenever needed. -A patch release will be cancelled for any of the following reasons: +A scheduled patch release will be cancelled for any of the following reasons: - if there is no new content since the previous release - if the patch release date falls within one week before the first release candidate (RC1) of an upcoming minor release - if the patch release date falls within four weeks following a minor release +- if a major or minor release is scheduled for the same month ## Minor releases diff --git a/docs/topics/version_skew.mdx b/docs/topics/version_skew.mdx index 75aca99577..ffacfd596b 100644 --- a/docs/topics/version_skew.mdx +++ b/docs/topics/version_skew.mdx @@ -15,7 +15,7 @@ Versioning](https://semver.org/spec/v2.0.0.html) terminology. The Helm project maintains a release branch for the most recent minor release. Applicable fixes, including security fixes, are cherry-picked into the release branch, depending on severity and feasibility. More details can be found in -[Helm's release policy](/topics/release_policy.md). +[Helm's release policy](/community/release_policy). ## Supported Version Skew diff --git a/i18n/ko/docusaurus-plugin-content-docs/version-3/topics/release_policy.md b/i18n/ko/docusaurus-plugin-content-docs-community/current/release_policy.md similarity index 100% rename from i18n/ko/docusaurus-plugin-content-docs/version-3/topics/release_policy.md rename to i18n/ko/docusaurus-plugin-content-docs-community/current/release_policy.md diff --git a/i18n/uk/docusaurus-plugin-content-blog/2025-09-09-path-to-helm-v4.md b/i18n/uk/docusaurus-plugin-content-blog/2025-09-09-path-to-helm-v4.md index 08879d13db..5aa544553e 100644 --- a/i18n/uk/docusaurus-plugin-content-blog/2025-09-09-path-to-helm-v4.md +++ b/i18n/uk/docusaurus-plugin-content-blog/2025-09-09-path-to-helm-v4.md @@ -24,7 +24,7 @@ date: "2025-09-09" Тестувальники повинні повідомляти про помилки, коли вони стикаються з будь-якими проблемами. -Відповідно до [політики випуску версій](/docs/topics/release_policy/#major-releases), після виходу першої бета-версії буде обрано та оголошено остаточну дату випуску версії 4.0.0. +Відповідно до [політики випуску версій](/community/release_policy#major-releases), після виходу першої бета-версії буде обрано та оголошено остаточну дату випуску версії 4.0.0. ## Претенденти на випуск {#release-candidates} diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/topics/release_policy.md b/i18n/uk/docusaurus-plugin-content-docs-community/current/release_policy.md similarity index 100% rename from i18n/uk/docusaurus-plugin-content-docs/current/topics/release_policy.md rename to i18n/uk/docusaurus-plugin-content-docs-community/current/release_policy.md diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/topics/version_skew.mdx b/i18n/uk/docusaurus-plugin-content-docs/current/topics/version_skew.mdx index 613b7fd390..83f28ed70a 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/topics/version_skew.mdx +++ b/i18n/uk/docusaurus-plugin-content-docs/current/topics/version_skew.mdx @@ -9,7 +9,7 @@ description: Описує політику випуску патчів Helm, а Версії Helm виражаються у форматі `x.y.z`, де `x` — це основна версія, `y` — це мінорна версія, а `z` — це версія патчу, відповідно до [семантичного версіювання](https://semver.org/lang/uk/spec/v2.0.0.html). -Проєкт Helm підтримує релізну гілку для останнього мінорного випуску. Застосовні виправлення, включаючи виправлення безпеки, додаються в релізну гілку залежно від їх серйозності та можливості впровадження. Більше деталей можна знайти в [політиці випусків Helm](/topics/release_policy.md). +Проєкт Helm підтримує релізну гілку для останнього мінорного випуску. Застосовні виправлення, включаючи виправлення безпеки, додаються в релізну гілку залежно від їх серйозності та можливості впровадження. Більше деталей можна знайти в [політиці випусків Helm](/community/release_policy). ## Підтримувана різниця версій {#supported-version-skew} diff --git a/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/release_policy.md b/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/release_policy.md deleted file mode 100644 index 584c5e4fa9..0000000000 --- a/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/release_policy.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Політика графіку випусків -description: Описує політику графіку випусків Helm. -sidebar_position: 17 ---- - -Для зручності користувачів Helm визначає та оголошує дати випусків заздалегідь. Цей документ описує політику, що регулює графік випусків Helm. - -## Календар випусків {#release-calendar} - -Публічний календар із запланованими випусками Helm можна знайти [тут](https://helm.sh/calendar/release). - -## Семантичне версіювання {#semantic-versioning} - -Версії Helm виражаються як `x.y.z`, де `x` — це основна версія, `y` — мінорна версія, а `z` — випуск патча, відповідно до термінології [семантичного версіювання](https://semver.org/spec/v2.0.0.html). - -## Випуски патчів {#patch-releases} - -Випуски патчів надають користувачам виправлення помилок і виправлення з безпеки. Вони не містять нових функцій. - -Новий випуск патча, що стосується останньої мінорної/основної версії, зазвичай здійснюється один раз на місяць, у другу середу кожного місяця. - -Випуск патча для виправлення пріоритетної регресії або проблеми безпеки може бути здійснений за потребою. - -Випуск патча буде скасовано з будь-якої з наступних причин: - -- якщо з моменту попереднього випуску не було додано нового вмісту; -- якщо дата випуску патча припадає на тиждень до першого реліз-кандидата (RC1) майбутнього мінорного випуску; -- якщо дата випуску патча припадає на чотири тижні після мінорного випуску. - -## Мінорні випуски {#minor-releases} - -Мінорні випуски містять виправлення безпеки та помилок, а також нові функції. Вони є зворотно сумісними з API та використанням CLI. - -Щоб узгодитися з випусками Kubernetes, мінорний випуск Helm здійснюється кожні 4 місяці (3 випуски на рік). - -Додаткові мінорні випуски можуть здійснюватися за потреби, але це не вплине на графік оголошеного майбутнього випуску, якщо до нього не залишилося менше 7 днів. - -Одночасно з публікацією випуску буде оголошено дату наступного мінорного випуску, яка буде опублікована на головній вебсторінці Helm. - -## Основні випуски - -Основні випуски містять зміни, що порушують сумісність. Такі випуски є рідкісними, але іноді необхідні для подальшого важливого розвитку Helm. - -Основні випуски можуть бути складними для планування. З огляду на це, остаточна дата випуску буде вибрана та оголошена лише після того, як буде доступна перша бета-версія такого випуску. diff --git a/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/version_skew.md b/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/version_skew.md index f3e0130185..0ed58a732a 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/version_skew.md +++ b/i18n/uk/docusaurus-plugin-content-docs/version-3/topics/version_skew.md @@ -10,7 +10,7 @@ sidebar_position: 15 Версії Helm виражаються у форматі `x.y.z`, де `x` — це основна версія, `y` — це мінорна версія, а `z` — це версія патчу, відповідно до [семантичного версіювання](https://semver.org/spec/v2.0.0.html). -Проєкт Helm підтримує релізну гілку для останнього мінорного випуску. Застосовні виправлення, включаючи виправлення безпеки, додаються в релізну гілку залежно від їх серйозності та можливості впровадження. Більше деталей можна знайти в [політиці випусків Helm](/topics/release_policy.md). +Проєкт Helm підтримує релізну гілку для останнього мінорного випуску. Застосовні виправлення, включаючи виправлення безпеки, додаються в релізну гілку залежно від їх серйозності та можливості впровадження. Більше деталей можна знайти в [політиці випусків Helm](/community/release_policy). ## Підтримувана різниця версій {#supported-version-skew} diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-3/topics/release_policy.md b/i18n/zh/docusaurus-plugin-content-docs-community/current/release_policy.md similarity index 100% rename from i18n/zh/docusaurus-plugin-content-docs/version-3/topics/release_policy.md rename to i18n/zh/docusaurus-plugin-content-docs-community/current/release_policy.md diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-3/topics/version_skew.md b/i18n/zh/docusaurus-plugin-content-docs/version-3/topics/version_skew.md index 14025a10bc..f235f52054 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-3/topics/version_skew.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-3/topics/version_skew.md @@ -11,7 +11,7 @@ Helm的版本用 `x.y.z` 描述，`x`是主版本，`y`是次版本，`z`是补 [语义化版本](https://semver.org/spec/v2.0.0.html) 术语。 Helm项目维护了一个针对最近次要版本的发布分支。适当的修复，包括安全修复、从发布分支中的cherry-pick， -视严重程度而定。更多细节请查看[Helm版本策略](https://helm.sh/zh/docs/topics/release_policy)。 +视严重程度而定。更多细节请查看[Helm版本策略](/community/release_policy)。 ## 可支持的版本偏差 diff --git a/netlify.toml b/netlify.toml index bc422f0225..703658a2d3 100755 --- a/netlify.toml +++ b/netlify.toml @@ -312,7 +312,43 @@ package = "./netlify-plugins/cache-docusaurus-dirs-file" # END - Hugo frontmatter aliases redirects + +# Moved to community section [[redirects]] from = "/docs/community/*" to = "/community/:splat" status = 302 + +# Community release policy +[[redirects]] + from = '/docs/topics/release_policy' + to = '/community/release_policy' + status = 302 + +[[redirects]] + from = '/docs/v3/topics/release_policy' + to = '/community/release_policy' + status = 302 + +# Community release policy (i18n/ko) +[[redirects]] + from = '/ko/docs/v3/topics/release_policy' + to = '/ko/community/release_policy' + status = 302 + +# Community release policy (i18n/uk) +[[redirects]] + from = '/uk/docs/topics/release_policy' + to = '/uk/community/release_policy' + status = 302 + +[[redirects]] + from = '/uk/docs/v3/topics/release_policy' + to = '/uk/community/release_policy' + status = 302 + +# Community release policy (i18n/zh) +[[redirects]] + from = '/zh/docs/v3/topics/release_policy' + to = '/zh/community/release_policy' + status = 302 diff --git a/versioned_docs/version-3/topics/release_policy.md b/versioned_docs/version-3/topics/release_policy.md deleted file mode 100644 index 3d5dcc4563..0000000000 --- a/versioned_docs/version-3/topics/release_policy.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: "Release schedule policy" -description: "Describes Helm's release schedule policy." ---- - -For the benefit of its users, Helm defines and announces release dates in -advance. This document describes the policy governing Helm's release schedule. - -## Release calendar - -A public calendar showing the upcoming Helm releases can be found [here](https://helm.sh/calendar/release). -## Semantic versioning - -Helm versions are expressed as `x.y.z`, where `x` is the major version, `y` is -the minor version, and `z` is the patch version, following [Semantic -Versioning](https://semver.org/spec/v2.0.0.html) terminology. - -## Patch releases - -Patch releases provide users with bug fixes and security fixes. They do not -contain new features. - -A new patch release relating to the latest minor/major release will normally be -done once a month on the second Wednesday of each month. - -A patch release to fix a high priority regression or security issue can be done -whenever needed. - -A patch release will be cancelled for any of the following reasons: -- if there is no new content since the previous release -- if the patch release date falls within one week before the first release candidate (RC1) of an upcoming minor release -- if the patch release date falls within four weeks following a minor release - -## Minor releases - -Minor releases contain security and bug fixes as well as new features. They -are backwards compatible with respect to the API and the CLI usage. - -To align with Kubernetes releases, a minor helm release will be done every -4 months (3 releases a year). - -Extra minor releases can be done if needed but will not affect the timeline of -an announced future release, unless the announced release is less than 7 days -away. - -At the same time as a release is published, the date of the next minor release -will be announced and posted to Helm's main web page. - -## Major releases - -Major releases contain breaking changes. Such releases are rare but are -sometimes necessary to allow helm to continue to evolve in important new -directions. - -Major releases can be difficult to plan. With that in mind, a final release -date will only be chosen and announced once the first beta version of such a -release is available. \ No newline at end of file diff --git a/versioned_docs/version-3/topics/version_skew.md b/versioned_docs/version-3/topics/version_skew.md index 61d77e7326..275ba5263c 100644 --- a/versioned_docs/version-3/topics/version_skew.md +++ b/versioned_docs/version-3/topics/version_skew.md @@ -15,7 +15,7 @@ Versioning](https://semver.org/spec/v2.0.0.html) terminology. The Helm project maintains a release branch for the most recent minor release. Applicable fixes, including security fixes, are cherry-picked into the release branch, depending on severity and feasibility. More details can be found in -[Helm's release policy](/topics/release_policy.md). +[Helm's release policy](/community/release_policy). ## Supported Version Skew