From 4fa1f2545a873ed5a7de7319fb096e0d8eea0bc5 Mon Sep 17 00:00:00 2001
From: Daniel Hilst <392820+dhilst@users.noreply.github.com>
Date: Fri, 25 Sep 2026 16:24:59 -0300
Subject: [PATCH] docs(developers): published .repo files name their series

The release checklist said that the published .repo files point at
latest. latest is a link into the newest series, so a file that names
it gives the next series to users of this one as soon as that series
ships. Each file under repos/yum/X.Y/ now names repos/yum/X.Y/, and the
installation check uses the files as published.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
---
 docs/source/developers/releases/checklist.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/source/developers/releases/checklist.rst b/docs/source/developers/releases/checklist.rst
index db884ad2d..6809f492b 100644
--- a/docs/source/developers/releases/checklist.rst
+++ b/docs/source/developers/releases/checklist.rst
@@ -106,8 +106,10 @@ The release is the last candidate that passed the tests.
     xcat-dep/2.x_Linux/xcat-dep-X.Y.Z-linux.tar.bz2
     xcat-dep/2.x_Ubuntu/xcat-dep-X.Y.Z-ubuntu.tar.bz2
 
-#. Make sure that the ``.repo`` files in the published repositories point at the published
-   location, not at ``devel``.
+#. Make sure that each ``.repo`` file under ``repos/yum/X.Y/`` points at ``repos/yum/X.Y/``, not at
+   ``devel`` or ``latest``. ``latest`` is a link into the newest series, so a series path is right
+   through both. A file that names ``latest`` gives the next series to users of this one as soon as
+   that series ships.
 
 #. If X.Y is the newest series, point ``latest`` at ``X.Y`` for yum and for apt.
 
@@ -146,9 +148,9 @@ Verify the Published Packages
    ``go-xcat`` installation does not prove the signatures.
 
    On EL, use the three published ``.repo`` files, which set ``gpgcheck=1``. Enable the other
-   repositories that the installation guide requires first. The published files point at
-   ``latest``. For an older series, replace ``latest`` with ``X.Y`` in the three files. Install the
-   Genesis image for the host architecture by name, because ``xCAT`` only recommends it. ::
+   repositories that the installation guide requires first. Use the files as published: each one
+   must point at ``repos/yum/X.Y/``. Install the Genesis image for the host architecture by name,
+   because ``xCAT`` only recommends it. ::
 
     $ curl -fsSo /etc/yum.repos.d/xcat-core.repo \
         https://xcat.org/files/xcat/repos/yum/X.Y/xcat-core/xcat-core.repo