From fc58bf208461753cd47a6b3504cb87a44e584a84 Mon Sep 17 00:00:00 2001
From: Matthias Klumpp <matthias@tenstral.net>
Date: Mon, 19 Feb 2024 02:51:11 +0100
Subject: [PATCH] docs: Clarify release descriptions *must not* contain
 embedded URL

Resolves: #578
---
 docs/xml/releases-data.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/xml/releases-data.xml b/docs/xml/releases-data.xml
index d50bf748..fd724078 100644
--- a/docs/xml/releases-data.xml
+++ b/docs/xml/releases-data.xml
@@ -148,7 +148,7 @@
 					The <literal>description</literal> tag supports child tags as described in <xref linkend="tag-description"/>.
 				</para>
 				<para>
-					It is recommended to not link to issue trackers or bug reports, as these typically make no sense to users.
+					Descriptions must not contain embedded web links to issue trackers or bug reports, as these typically make no sense to users.
 					If particular issues need to be highlighted (for example, CVEs fixed in this release), they should be listed in the <literal>issues</literal> tag.
 				</para>
 			</listitem>