doc/releases: Add ordering comment to releases.yml

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit 2290a904bd6a3194f77b76d7deb0c9d24c8b4b93)

diff --git a/doc/releases/releases.yml b/doc/releases/releases.yml
index 5b8f913cade4b4ce26da6b7f70d82eb04b15b774..cc984c5288f1a724b5075de8a1766a189f89953f 100644 (file)
--- a/doc/releases/releases.yml
+++ b/doc/releases/releases.yml
@@ -1,5 +1,5 @@
 #
-# there are two sections
+# There are two sections
 #
 # releases: ... for named releases
 # development: ... for dev releases
@@ -11,6 +11,10 @@
 #
 # If a version might represent an actual number (e.g. 0.80) quote it.
 #
+# Note that in order for the Gantt chart to properly reflect the latest version
+#      of a major release, the versions within a `releases` list MUST be
+#      in descending order.
+
 releases:
   squid:
     target_eol: 2026-09-19