doc/releases: Add ordering comment to releases.yml

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>

diff --git a/doc/releases/releases.yml b/doc/releases/releases.yml
index 73a988cbac7c9c9270cbd7a61cb114208a62a212..5ae81fa1dbd208c1acc842b24c4fe2dc91797ea4 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