From 36aae089f6232a902dda383f0755b1afb3cf268b Mon Sep 17 00:00:00 2001
From: Glen Barber <gjb@FreeBSD.org>
Date: Wed, 30 Sep 2020 15:50:24 +0000
Subject: [PATCH] Add a section noting what files to update on the website when
 a release reaches End-of-Life.

Discussed with:	emaste
Sponsored by:	Rubicon Communications, LLC (netgate.com)
---
 .../articles/freebsd-releng/article.xml       | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/en_US.ISO8859-1/articles/freebsd-releng/article.xml b/en_US.ISO8859-1/articles/freebsd-releng/article.xml
index 6f1ac25ad4..0c5b5c7073 100644
--- a/en_US.ISO8859-1/articles/freebsd-releng/article.xml
+++ b/en_US.ISO8859-1/articles/freebsd-releng/article.xml
@@ -495,4 +495,70 @@
     </sect2>
   </sect1>
 
+  <sect1 xml:id="releng-eol">
+    <title>Release End-of-Life</title>
+
+    <para>This section describes the website-related files to update
+      when a release reaches <acronym>EoL</acronym>
+      (End-of-Life).</para>
+
+    <sect2 xml:id="releng-eol-website">
+      <title>Website Updates for End-of-Life</title>
+
+      <para>When a release reaches End-of-Life, references to that
+	release should be removed and/or updated on the
+	website:</para>
+
+      <informaltable frame="none" pgwide="0">
+	<tgroup cols="2">
+	  <thead>
+	    <row>
+	      <entry>File</entry>
+	      <entry>What to Change</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry><filename>head/en_US.ISO8859-1/htdocs/index.xsl</filename></entry>
+	      <entry>Remove <literal>&amp;u.relXXX.announce;</literal>
+		and <literal>&amp;u.relXXX.current;</literal>
+		references.</entry>
+	    </row>
+
+	    <row>
+	      <entry><filename>head/en_US.ISO8859-1/htdocs/releases/index.xml</filename></entry>
+	      <entry>Move the &amp;u.relXXX.*; macros from the
+		supported release list to the Legacy Releases
+		list.</entry>
+	    </row>
+
+	    <row>
+	      <entry><filename>head/en_US.ISO8859-1/htdocs/releng/index.xml</filename></entry>
+	      <entry>Update the appropriate releng branch to refelect
+		the branch is no longer supported.</entry>
+	    </row>
+
+	    <row>
+	      <entry><filename>head/en_US.ISO8859-1/htdocs/security/security.xml</filename></entry>
+	      <entry>Remove the branch from the supported branch
+		list.</entry>
+	    </row>
+
+	    <row>
+	      <entry><filename>head/en_US.ISO8859-1/htdocs/where.xml</filename></entry>
+	      <entry>Remove the URLs for the release.</entry>
+	    </row>
+
+	    <row>
+	      <entry><filename>head/share/xml/navibar.ent</filename></entry>
+	      <entry>Remove <literal>&amp;u.relXXX.announce;</literal>
+		and <literal>&amp;u.relXXX.current;</literal>
+		references.</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </informaltable>
+    </sect2>
+  </sect1>
 </article>