add Versions section (#1784)

* add Versions section

Signed-off-by: William Morgan <[email protected]>

* lint

Signed-off-by: William Morgan <[email protected]>

* liint

Signed-off-by: William Morgan <[email protected]>

* add pointer to version tag

Signed-off-by: William Morgan <[email protected]>

* more tweaking

Signed-off-by: William Morgan <[email protected]>

* liiint

Signed-off-by: William Morgan <[email protected]>

---------

Signed-off-by: William Morgan <[email protected]>

linkerd.io/content/releases/_index.md

@@ -4,51 +4,67 @@ 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
+
+Linkerd 2.15 was announced on February 21, 2024.
 
-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:
+- **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)
 
-- [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/)].
+Known distributions of Linkerd 2.15:
 
-## Edge releases
+- [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
+
+<!-- markdownlint-disable MD034 -->
 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.
 
-<!-- markdownlint-disable MD034 -->
+### Stable releases
+
+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.
 
-Latest version: **{{% latestedge %}}** [[release
-notes](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}})].
+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.