Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 8 Oct 2024 17:10:29 GMT
From:      Colin Percival <cperciva@FreeBSD.org>
To:        doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org
Subject:   git: d2a8768dc2 - main - Mark 13.[34] consistently as "legacy" releases
Message-ID:  <202410081710.498HATYt081780@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by cperciva:

URL: https://cgit.FreeBSD.org/doc/commit/?id=d2a8768dc24c03dc7e5c501130b7dfd68508bebe

commit d2a8768dc24c03dc7e5c501130b7dfd68508bebe
Author:     Colin Percival <cperciva@FreeBSD.org>
AuthorDate: 2024-10-08 17:04:20 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2024-10-08 17:04:20 +0000

    Mark 13.[34] consistently as "legacy" releases
    
    While the front page of the FreeBSD website marked these are legacy
    releases, the /where/ and /releases/ did not, resulting in confusion
    from new users about which FreeBSD release they should download.
    
    With hat:       re
    Reported by:    Graham Perrin
    Sponsored by:   Amazon
---
 website/content/en/releases/_index.adoc | 21 +++++----------------
 website/content/en/where.adoc           |  6 +++++-
 2 files changed, 10 insertions(+), 17 deletions(-)

diff --git a/website/content/en/releases/_index.adoc b/website/content/en/releases/_index.adoc
index 3266bf07b7..5c1a10fcb7 100644
--- a/website/content/en/releases/_index.adoc
+++ b/website/content/en/releases/_index.adoc
@@ -10,16 +10,11 @@ include::shared/en/urls.adoc[]
 
 [.right]
 image:../gifs/releases.jpg[FreeBSD Releases,width=300,height=200]
-////
-// <https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266094#c2>;
 
-FreeBSD releases are classified into _Production Releases_ and _Legacy Releases_. Production releases are best suited to users looking for the latest new features. Legacy releases are for users wishing to stay with a more conservative upgrade strategy.
-////
-////
-// <https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266094#c2>;
+FreeBSD releases are classified into _Production Releases_ and _Legacy Releases_.
+For most users, production releases will be most suitable.
+Legacy releases are provided for existing users wishing to stay with a more conservative upgrade strategy.
 
-Documentation files for each release are at link:../relnotes/[Release Documentation].
-////
 [[supported-releases]]
 == Currently Supported
 
@@ -28,20 +23,14 @@ For information about branches, release dates, and estimated end-of-life (EOL) d
 [[current]]
 == Most Recent
 
-////
 === Production Releases
-////
-Production:
 
-* *Release {rel133-current}* ({rel133-current-date}) _link:{u-rel133-announce}[Announcement] : link:{u-rel133-notes}[Release Notes] : link:{u-rel133-installation}[Installation Instructions] : link:{u-rel133-hardware}[Hardware Compatibility List] : link:{u-rel133-readme}[Readme] : link:{u-rel133-errata}[Errata] : link:{u-rel133-signatures}[Signed Checksums]_
-* *Release {rel134-current}* ({rel134-current-date}) _link:{u-rel134-announce}[Announcement] : link:{u-rel134-notes}[Release Notes] : link:{u-rel134-installation}[Installation Instructions] : link:{u-rel134-hardware}[Hardware Compatibility List] : link:{u-rel134-readme}[Readme] : link:{u-rel134-errata}[Errata] : link:{u-rel134-signatures}[Signed Checksums]_
 * *Release {rel141-current}* ({rel141-current-date}) _link:{u-rel141-announce}[Announcement] : link:{u-rel141-notes}[Release Notes] : link:{u-rel141-installation}[Installation Instructions] : link:{u-rel141-hardware}[Hardware Compatibility List] : link:{u-rel141-readme}[Readme] : link:{u-rel141-errata}[Errata] : link:{u-rel141-signatures}[Signed Checksums]_
 
-////
 === Legacy
 
-*Release {rel112-current}* ({rel112-current-date}) _link:{u-rel112-announce}[Announcement] : link:{u-rel112-notes}[Release Notes] : link:{u-rel112-installation}[Installation Instructions] : link:{u-rel112-hardware}[Hardware Notes] : link:{u-rel112-readme}[Readme] : link:{u-rel112-errata}[Errata] : link:{u-rel112-signatures}[Checksums]_
-////
+* *Release {rel133-current}* ({rel133-current-date}) _link:{u-rel133-announce}[Announcement] : link:{u-rel133-notes}[Release Notes] : link:{u-rel133-installation}[Installation Instructions] : link:{u-rel133-hardware}[Hardware Compatibility List] : link:{u-rel133-readme}[Readme] : link:{u-rel133-errata}[Errata] : link:{u-rel133-signatures}[Signed Checksums]_
+* *Release {rel134-current}* ({rel134-current-date}) _link:{u-rel134-announce}[Announcement] : link:{u-rel134-notes}[Release Notes] : link:{u-rel134-installation}[Installation Instructions] : link:{u-rel134-hardware}[Hardware Compatibility List] : link:{u-rel134-readme}[Readme] : link:{u-rel134-errata}[Errata] : link:{u-rel134-signatures}[Signed Checksums]_
 
 [[future]]
 == Future
diff --git a/website/content/en/where.adoc b/website/content/en/where.adoc
index afa22ae030..9d01f4ca38 100644
--- a/website/content/en/where.adoc
+++ b/website/content/en/where.adoc
@@ -37,7 +37,7 @@ For embedded platforms: SD card images are available.
 [[download]]
 == Production Quality
 
-`RELEASE` versions of FreeBSD are the end result of _release engineering_.
+`RELEASE` versions of FreeBSD are the end result of _release engineering_ and are recommended for most users.
 
 [[download-rel141]]
 === FreeBSD {rel141-current}-RELEASE
@@ -93,6 +93,10 @@ a|
 
 |===
 
+== Production Quality (legacy)
+
+Some FreeBSD `RELEASEs` are supported but are older or built from older `STABLE` branches; these are considered "legacy" and are probably only of interest to people maintaining existing systems on FreeBSD.
+
 [[download-rel134]]
 === FreeBSD {rel134-current}-RELEASE
 [.tblbasic]



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202410081710.498HATYt081780>