From 7d5f77475122bdfc9953d7059846f78007731748 Mon Sep 17 00:00:00 2001
From: David Davis <86290+daviddavis@users.noreply.github.com>
Date: Mon, 22 Jun 2026 19:15:26 +0000
Subject: [PATCH] Clarify DISTRIBUTED_PUBLICATION_RETENTION_PERIOD

Clarify what files are being served by the publication retention feature
since it wasn't obvious.
---
 docs/admin/reference/settings.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/admin/reference/settings.md b/docs/admin/reference/settings.md
index cd30c2ae37..5ce1cc3c8c 100644
--- a/docs/admin/reference/settings.md
+++ b/docs/admin/reference/settings.md
@@ -282,6 +282,8 @@ See [Database Encryption] for more details.
 When a distribution switches to a newer publication, the previously served (superseded) publication continues to be available for this many seconds.
 This grace period prevents 404 errors for clients that began downloading from the old publication before the switch occurred.
 
+The grace period applies to every file in the publication, including repository metadata (such as `repomd.xml` or `primary.xml.gz`), not just package or content artifacts.
+
 Set to `0` to disable the grace period and serve only the latest publication immediately.
 
 Defaults to `259200` seconds (3 days).