From a616e6bd2a452532cf27d50a7020378608f21b37 Mon Sep 17 00:00:00 2001 From: Simon Branford Date: Tue, 4 Jul 2023 19:17:18 +0100 Subject: [PATCH 1/4] Support Toolchain Generations Policy --- docs/policies/toolchains.md | 31 +++++++++++++++++++++++++++++++ mkdocs.yml | 2 ++ 2 files changed, 33 insertions(+) create mode 100644 docs/policies/toolchains.md diff --git a/docs/policies/toolchains.md b/docs/policies/toolchains.md new file mode 100644 index 000000000..49adc962a --- /dev/null +++ b/docs/policies/toolchains.md @@ -0,0 +1,31 @@ +# Supported Toolchain Generations Policy {: #policy_toolchains } + +!!! note + This policy will be implemented as part of the release of [EasyBuild 5.0][overview] + +For the central EasyBuild repositories, we support a set of toolchain generations. + +* Accept PRs only for the 6 most recent toolchain generations. +* Deprecate toolchains generations 7 and 8, including closing PRs and issues for these toolchains. +* Archive easyconfigs using toolchain generation 9 (and older). + +## Notes + +* This assumes we continue with two toolchain generations per year. +* A toolchain generation exists when we have an lettered (i.e. 2024a) toolchain in `develop`. + +## Background + +The central easyconfigs repository is intended to provide references easyconfigs. For the reference easyconfigs we +aim to have only one version of a software being used as a dependency in each toolchain generation. (There are +exceptions, but we aim to keep these limited.) + +Sites and users can then supplement these easyconfigs via there own collection of easyconfigs. This additional +collection is added via the [robot search path][robot_search_path]. + +## Example + +As of July 2023 the latest toolchain generation is `2023a`. +* Supported: 2022b, 2022a, 2021b, 2021a, 2020b, 2020a +* Deprecated: 2019b and 2019a +* Archived (and unsupported): 2018b and older diff --git a/mkdocs.yml b/mkdocs.yml index 141598c08..f72b444b5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -108,6 +108,8 @@ nav: - List of supported software: version-specific/supported-software.md - Getting help: getting-help.md - User survey: user-survey/index.md + - Policies: + Supported Toolchain Generations: policies/toolchains.md - Other topics: - Alternative installation methods: installation-alternative.md - Configuration (legacy): legacy/configuration.md From 3f12f3246914fd3acb65ba8386dc1eb86ecc7ad1 Mon Sep 17 00:00:00 2001 From: Simon Branford Date: Tue, 4 Jul 2023 19:19:18 +0100 Subject: [PATCH 2/4] linting --- docs/policies/toolchains.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/policies/toolchains.md b/docs/policies/toolchains.md index 49adc962a..0a4851dc6 100644 --- a/docs/policies/toolchains.md +++ b/docs/policies/toolchains.md @@ -26,6 +26,7 @@ collection is added via the [robot search path][robot_search_path]. ## Example As of July 2023 the latest toolchain generation is `2023a`. + * Supported: 2022b, 2022a, 2021b, 2021a, 2020b, 2020a * Deprecated: 2019b and 2019a * Archived (and unsupported): 2018b and older From d86c7e80d75392b30a71495b8a942e31894c66ea Mon Sep 17 00:00:00 2001 From: Simon Branford Date: Tue, 4 Jul 2023 19:23:22 +0100 Subject: [PATCH 3/4] linting --- docs/policies/toolchains.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/policies/toolchains.md b/docs/policies/toolchains.md index 0a4851dc6..c67ef48ae 100644 --- a/docs/policies/toolchains.md +++ b/docs/policies/toolchains.md @@ -30,3 +30,4 @@ As of July 2023 the latest toolchain generation is `2023a`. * Supported: 2022b, 2022a, 2021b, 2021a, 2020b, 2020a * Deprecated: 2019b and 2019a * Archived (and unsupported): 2018b and older + From c7b0463ad183d18035b0355c269c45e0693192a5 Mon Sep 17 00:00:00 2001 From: Simon Branford <4967+branfosj@users.noreply.github.com> Date: Thu, 12 Oct 2023 13:02:09 +0100 Subject: [PATCH 4/4] redo example based on 2023b --- docs/policies/toolchains.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/policies/toolchains.md b/docs/policies/toolchains.md index c67ef48ae..69fc9e086 100644 --- a/docs/policies/toolchains.md +++ b/docs/policies/toolchains.md @@ -25,9 +25,9 @@ collection is added via the [robot search path][robot_search_path]. ## Example -As of July 2023 the latest toolchain generation is `2023a`. +As of November 2023 the latest toolchain generation is `2023b`. -* Supported: 2022b, 2022a, 2021b, 2021a, 2020b, 2020a -* Deprecated: 2019b and 2019a -* Archived (and unsupported): 2018b and older +* Supported: 2023b, 2023a, 2022b, 2022a, 2021b, 2021a +* Deprecated: 2020b and 2020a +* Archived (and unsupported): 2019b and older