svn commit: r50563 - head/en_US.ISO8859-1/articles/freebsd-releng

[Glen Barber]

Author: gjb
Date: Tue Jul 25 17:50:09 2017
New Revision: 50563
URL: https://svnweb.freebsd.org/changeset/doc/50563

Log:
  Add a section as a starting point for various website updates that
  are needed during the release cycle.
  
  Sponsored by:	The FreeBSD Foundation

Added:
  head/en_US.ISO8859-1/articles/freebsd-releng/releng-website.xml   (contents, props changed)
Modified:
  head/en_US.ISO8859-1/articles/freebsd-releng/article.xml

Modified: head/en_US.ISO8859-1/articles/freebsd-releng/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/freebsd-releng/article.xml	Tue Jul 25 15:45:07 2017	(r50562)
+++ head/en_US.ISO8859-1/articles/freebsd-releng/article.xml	Tue Jul 25 17:50:09 2017	(r50563)
@@ -22,6 +22,7 @@
 <!ENTITY release.minor.version SYSTEM "./releng-minor-version.xml">
 <!ENTITY release.mirrors SYSTEM "./releng-mirrors.xml">
 <!ENTITY release.terminology SYSTEM "./releng-terminology.xml">
+<!ENTITY release.website SYSTEM "./releng-website.xml">
 ]>
 <article xmlns="http://docbook.org/ns/docbook"
   xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
@@ -109,6 +110,14 @@
       </varlistentry>
 
       <varlistentry>
+	<term><xref linkend="releng-website"/></term>
+
+	<listitem>
+	  <para>Website Changes During the Release Cycle</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
 	<term><xref linkend="releng-terms"/></term>
 
 	<listitem>
@@ -421,6 +430,7 @@
   </sect1>
 
   &release.terminology;
+  &release.website;
   &release.major.version;
   &release.minor.version;
   &release.building;

Added: head/en_US.ISO8859-1/articles/freebsd-releng/releng-website.xml
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/en_US.ISO8859-1/articles/freebsd-releng/releng-website.xml	Tue Jul 25 17:50:09 2017	(r50563)
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+     The FreeBSD Documentation Project
+
+     $FreeBSD$
+-->
+<sect1 xml:id="releng-website">
+  <title>Website Changes During the Release Cycle</title>
+
+  <para>This section describes the changes to the website that should
+    occur as the release cycle progresses.</para>
+
+  <note>
+    <para>The files specified throughout this section are relative to
+      the <literal>head/</literal> branch of the
+      <literal>doc</literal> repository in
+      <application>Subversion</application>.</para>
+  </note>
+
+  <sect2 xml:id="releng-website-prerelease">
+    <title>Website Changes Before the Release Cycle Begins</title>
+
+    <para>When the release cycle schedule is available, these files
+      need to be updated to enable various different functionalities
+      on the &os; Project website:</para>
+
+    <informaltable frame="none" pgwide="0">
+      <tgroup cols="2">
+	<thead>
+	  <row>
+	    <entry>File to Edit</entry>
+	    <entry>What to Change</entry>
+	  </row>
+	</thead>
+
+	<tbody>
+	  <row>
+	    <entry><filename>share/xml/release.ent</filename></entry>
+	    <entry>Change <literal>beta.upcoming</literal>
+	      from <literal>IGNORE</literal> to <literal>INCLUDE</literal></entry>
+	  </row>
+
+	  <row>
+	    <entry><filename>share/xml/release.ent</filename></entry>
+	    <entry>Change <literal>% beta.upcoming</literal>
+	      from <literal>IGNORE</literal> to <literal>INCLUDE</literal></entry>
+	  </row>
+
+	  <row>
+	    <entry><filename>share/xml/release.ent</filename></entry>
+	    <entry>Change <literal>beta.testing</literal>
+	      from <literal>IGNORE</literal> to <literal>INCLUDE</literal></entry>
+	  </row>
+
+	  <row>
+	    <entry><filename>share/xml/release.ent</filename></entry>
+	    <entry>Change <literal>% beta.testing</literal>
+	      from <literal>IGNORE</literal> to <literal>INCLUDE</literal></entry>
+	  </row>
+	</tbody>
+      </tgroup>
+    </informaltable>
+  </sect2>
+
+  <sect2 xml:id="releng-website-beta-rc">
+    <title>Website Changes During <literal>BETA</literal> or
+      <literal>RC</literal></title>
+
+    <para>When transitioning from <literal>PRERELEASE</literal> to
+      <literal>BETA</literal>, these files need to be updated to
+      enable the "Help Test" block on the download page.
+      All files are relative to <filename
+	class="directory">head/</filename> in the
+      <literal>doc</literal> repository:</para>
+
+    <informaltable frame="none" pgwide="0">
+      <tgroup cols="2">
+	<thead>
+	  <row>
+	    <entry>File to Edit</entry>
+	    <entry>What to Change</entry>
+	  </row>
+	</thead>
+
+	<tbody>
+	  <row>
+	    <entry><filename>en_US.ISO8859-1/htdocs/releases/11.0R/schedule.xml</filename></entry>
+	    <entry>Change <literal>% beta.local.where</literal>
+	      <literal>IGNORE</literal> to
+	      <literal>INCLUDE</literal></entry>
+	  </row>
+
+	  <row>
+	    <entry><filename>share/xml/release.ent</filename></entry>
+	    <entry>Update <literal>% betarel.vers</literal> to
+	      <literal>BETA<replaceable>1</replaceable></literal></entry>
+	  </row>
+
+	  <row>
+	    <entry><filename>share/xml/news.xml</filename></entry>
+	    <entry>Add an entry announcing the
+	      <literal>BETA</literal></entry>
+	  </row>
+	</tbody>
+      </tgroup>
+    </informaltable>
+  </sect2>
+</sect1>