From c5ba01e2dd0610b66357ad75d4892fa80c827376 Mon Sep 17 00:00:00 2001 From: William Morgan Date: Tue, 4 Jun 2024 13:19:05 -0500 Subject: [PATCH 1/6] add Versions section Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index f61c2562aa..78f37a95b4 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -50,5 +50,19 @@ artifacts. -Latest version: **{{% latestedge %}}** [[release -notes](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}})]. +## Versions + +Like many projects, Linkerd publishes and announces major *versions* that +correspond to specific project milestones and sets of new features. + +### Linkerd 2.15 + +The latest major version is Linkerd 2.15. + +* Release date: February 21, 2024. +* Full announcement: [Announcing Linkerd 2.15 with mesh expansion, native +sidecars, and SPIFFE ](/2024/02/21/announcing-linkerd-2.15/). +* Edge releases: +[edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) +through [{{% latestedge %}}](https://github.com/linkerd/linkerd2/releases/tag/{{% +latestedge %}}). From 85f43d2599713499cd3fb1a945340c1f14fc6877 Mon Sep 17 00:00:00 2001 From: William Morgan Date: Tue, 4 Jun 2024 15:49:15 -0500 Subject: [PATCH 2/6] lint Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index 78f37a95b4..23642bf144 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -59,10 +59,9 @@ correspond to specific project milestones and sets of new features. The latest major version is Linkerd 2.15. -* Release date: February 21, 2024. -* Full announcement: [Announcing Linkerd 2.15 with mesh expansion, native -sidecars, and SPIFFE ](/2024/02/21/announcing-linkerd-2.15/). -* Edge releases: +- Release date: February 21, 2024. +- Full announcement: [Announcing Linkerd 2.15 with mesh expansion, native sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/). +- Edge releases: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) through [{{% latestedge %}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}). From 372c09b4a88702ae704a91c174d25e61caf265a4 Mon Sep 17 00:00:00 2001 From: William Morgan Date: Tue, 4 Jun 2024 16:47:49 -0500 Subject: [PATCH 3/6] liint Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index 23642bf144..e188ee7bee 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -60,8 +60,9 @@ correspond to specific project milestones and sets of new features. The latest major version is Linkerd 2.15. - Release date: February 21, 2024. -- Full announcement: [Announcing Linkerd 2.15 with mesh expansion, native sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/). +- Announcement post: [Announcing Linkerd 2.15 with mesh expansion, native +sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/). - Edge releases: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) -through [{{% latestedge %}}](https://github.com/linkerd/linkerd2/releases/tag/{{% -latestedge %}}). +through [{{% latestedge +%}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}). From abc59136f8e7a1b7f69564adb3d3a1601c8a2bf5 Mon Sep 17 00:00:00 2001 From: William Morgan Date: Wed, 5 Jun 2024 14:31:17 -0500 Subject: [PATCH 4/6] add pointer to version tag Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index e188ee7bee..d769fafaa3 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -62,6 +62,8 @@ The latest major version is Linkerd 2.15. - Release date: February 21, 2024. - Announcement post: [Announcing Linkerd 2.15 with mesh expansion, native sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/). +- Code tag: +[version-2.15](https://github.com/linkerd/linkerd2/releases/tag/version-2.15). - Edge releases: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) through [{{% latestedge From 64bda3ea33caea6d6829d3900ca9085d0c26351a Mon Sep 17 00:00:00 2001 From: William Morgan Date: Wed, 5 Jun 2024 15:19:17 -0500 Subject: [PATCH 5/6] more tweaking Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 77 +++++++++++++-------------- 1 file changed, 38 insertions(+), 39 deletions(-) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index d769fafaa3..5c16d767b0 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -4,67 +4,66 @@ aliases = [ "edge" ] weight = 18 +++ -Releases of Linkerd are available in several different forms. +Linkerd publishes and announces *versions* that correspond to specific project +milestones and sets of new features. These versions are available in different +types of *release artifacts*. -## Stable releases +## Recent versions -Stable release artifacts of Linkerd follow semantic versioning, whereby changes -in major version denote large feature additions and possible breaking changes -and changes in minor versions denote safe upgrades without breaking changes. +### Linkerd 2.15 -As of February 2024, Linkerd no longer provides stable release artifacts in the -open source project itself. Instead, the vendor community around Linkerd is -responsible for creating stable release artifacts. Known distributions of -Linkerd with stable release artifacts include: +Linkerd 2.15 was announced on February 21, 2024. -- [Buoyant Enterprise for Linkerd](https://docs.buoyant.io/buoyant-enterprise-linkerd) - from Buoyant, creators of Linkerd. - Latest version: **enterprise-2.15.3** - [[release notes](https://docs.buoyant.io/release-notes/buoyant-enterprise-linkerd/enterprise-2.15.3/)]. +- **Announcement**: [Announcing Linkerd 2.15 with mesh expansion, native +sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/) +- **Code tag**: +[version-2.15](https://github.com/linkerd/linkerd2/releases/tag/version-2.15) +- **Corresponding edge release**: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) -## Edge releases +Known distributions of Linkerd 2.15: +- [Buoyant Enterprise for + Linkerd](https://docs.buoyant.io/buoyant-enterprise-linkerd) from Buoyant, + creators of Linkerd. Latest version: **enterprise-2.15.3** ([release + notes](https://docs.buoyant.io/release-notes/buoyant-enterprise-linkerd/enterprise-2.15.3/)). + +## Types of release artifacts + +### Edge releases Edge release artifacts are published on a weekly or near-weekly basis as part of -the open source project. The full list of edge release artifacts can be found on -[the Linkerd GitHub releases -page](https://github.com/linkerd/linkerd2/releases). +the open source project. The latest edge release is [{{% latestedge +%}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}). +and the full list of edge release artifacts can be found on [the Linkerd GitHub +releases page](https://github.com/linkerd/linkerd2/releases). Edge release artifacts contain the code in from the _main_ branch at the point in time when they were cut. This means they always have the latest features and -fixes, and have undergone automated testing as well as maintianer code review. +fixes, and have undergone automated testing as well as maintainer code review. Edge releases may involve partial features that are later modified or backed out. They may also involve breaking changes—of course, we do our best to avoid this. +Edge releases are generally considered *production ready*, and the project will +mark specific releases as "not recommended" if bugs are discovered after +release. + Edge release versioning follows the form `edge-y.m.n`, where `y` is the last two digits of the year, `m` is the numeric month, and `n` is numeric edge release -count for that month. For example: - -- `edge-23.9.1`: the first edge release shipped in September 2023 -- `edge-24.1.3`: the third edge release shipped in January 2024 +count for that month. For example, `edge-24.1.3` is the third edge release +shipped in January 2024. Using edge release artifacts and reporting bugs helps us ensure a rapid pace of development and is a great way to help Linkerd. We publish edge release guidance as part of the release notes and strive to always provide production-ready artifacts. - - -## Versions +### Stable releases -Like many projects, Linkerd publishes and announces major *versions* that -correspond to specific project milestones and sets of new features. - -### Linkerd 2.15 +Stable release artifacts of Linkerd follow semantic versioning, whereby changes +in major version denote large feature additions and possible breaking changes +and changes in minor versions denote safe upgrades without breaking changes. -The latest major version is Linkerd 2.15. +As of February 2024, the Linkerd open source project itself no longer provides +stable release artifacts. Instead, the vendor community around Linkerd is +responsible for creating stable release artifacts. -- Release date: February 21, 2024. -- Announcement post: [Announcing Linkerd 2.15 with mesh expansion, native -sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/). -- Code tag: -[version-2.15](https://github.com/linkerd/linkerd2/releases/tag/version-2.15). -- Edge releases: -[edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) -through [{{% latestedge -%}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}). From e39b06fec2000a2564995d8ae65b2cd41381afd2 Mon Sep 17 00:00:00 2001 From: William Morgan Date: Wed, 5 Jun 2024 16:41:06 -0500 Subject: [PATCH 6/6] liiint Signed-off-by: William Morgan --- linkerd.io/content/releases/_index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md index 5c16d767b0..727a580810 100644 --- a/linkerd.io/content/releases/_index.md +++ b/linkerd.io/content/releases/_index.md @@ -21,6 +21,7 @@ sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/) - **Corresponding edge release**: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4) Known distributions of Linkerd 2.15: + - [Buoyant Enterprise for Linkerd](https://docs.buoyant.io/buoyant-enterprise-linkerd) from Buoyant, creators of Linkerd. Latest version: **enterprise-2.15.3** ([release @@ -30,6 +31,7 @@ Known distributions of Linkerd 2.15: ### Edge releases + Edge release artifacts are published on a weekly or near-weekly basis as part of the open source project. The latest edge release is [{{% latestedge %}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}). @@ -66,4 +68,3 @@ and changes in minor versions denote safe upgrades without breaking changes. As of February 2024, the Linkerd open source project itself no longer provides stable release artifacts. Instead, the vendor community around Linkerd is responsible for creating stable release artifacts. -