MFC [1] r278115, r278116:

 r278115:
  Move the 'Upgrading from Previous Releases of FreeBSD'
  section to the top of the file, following the introduction.

 r278116:
  Overhaul the relnotes page to reorganize the sections.

  With the previous layout, the majority of the release
  notes were categorized under one main "What's New"
  section, which in addition to making the page difficult
  to parse relevant bits, also had a few rendering issues,
  such as 'Note' blocks visually not appearing as if they
  pertain to a particular change.

  This change removes the "What's New" section, integrating
  it with the introduction.  In addition, each section now
  provides a brief description of its contents, broken down
  further into a subsection for each "topic", making it much
  easier to find a specific topic in the page.

[1] This is a direct commit, not an MFC.

Sponsored by:	The FreeBSD Foundation

1 files changed, 256 insertions, 106 deletions

diff --git a/release/doc/en_US.ISO8859-1/relnotes/article.xml b/release/doc/en_US.ISO8859-1/relnotes/article.xml
index 3496e57..4ded9f3 100644
--- a/release/doc/en_US.ISO8859-1/relnotes/article.xml
+++ b/release/doc/en_US.ISO8859-1/relnotes/article.xml
@@ -90,12 +90,8 @@
       information on known bugs, security advisories, and corrections
       to documentation.  An up-to-date copy of the errata for &os;
       &release.current; can be found on the &os; Web site.</para>
-  </sect1>
-
-  <sect1 xml:id="new">
-    <title>What's New</title>
 
-    <para>This section describes the most user-visible new or changed
+    <para>This document describes the most user-visible new or changed
       features in &os; since &release.prev;.</para>
 
     <para>Typical release note items document recent security
@@ -107,166 +103,320 @@
       between releases; this document focuses primarily on security
       advisories, user-visible changes, and major architectural
       improvements.</para>
+  </sect1>
+
+  <sect1 xml:id="upgrade">
+    <title>Upgrading from Previous Releases of &os;</title>
+
+    <para arch="amd64,i386">Binary upgrades between RELEASE versions
+      (and snapshots of the various security branches) are supported
+      using the &man.freebsd-update.8; utility.  The binary upgrade
+      procedure will update unmodified userland utilities, as well as
+      unmodified <filename>GENERIC</filename> kernel distributed as
+      a part of an official &os; release.  The &man.freebsd-update.8;
+      utility requires that the host being upgraded have Internet
+      connectivity.</para>
+
+    <para>Source-based upgrades (those based on recompiling the &os;
+      base system from source code) from previous versions are
+      supported, according to the instructions in
+      <filename>/usr/src/UPDATING</filename>.</para>
+
+    <important>
+      <para>Upgrading &os; should only be attempted after
+	backing up <emphasis>all</emphasis> data and configuration
+	files.</para>
+    </important>
+  </sect1>
+
+  <sect1 xml:id="security-errata">
+    <title>Security and Errata</title>
+
+    <para>This section lists the various Security Advisories and
+      Errata Notices since &release.prev;.</para>
 
     <sect2 xml:id="security">
       <title>Security Advisories</title>
 
+      <para>No advisories.</para>
+    </sect2>
+
+    <sect2 xml:id="errata">
+      <title>Errata Notices</title>
+
+      <para>No errata notices.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="userland">
+    <title>Userland</title>
+
+    <para>This section covers changes and additions to userland
+      applications, contributed software, and system utilities.</para>
+
+    <sect2 xml:id="userland-config">
+      <title>Userland Configuration Changes</title>
+
+      <para revision="276991">The &man.termcap.5; file is installed
+	as-is from sources, instead of reordering, creating
+	<filename>/etc/termcap.db</filename> by default, providing
+	a performance improvements to applications that use the
+	&man.termcap.5; database, such as &man.vi.1; and
+	&man.ncurses.3;.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-programs">
+      <title>Userland Application Changes</title>
+
+      <para revision="275040">A new utility, &man.dpv.1;, has been
+	added to the base system, providing a &man.dialog.1;-style
+	progress view from one or more input streams.  A corresponding
+	library, &man.dpv.3;, has also been added.</para>
+
+      <para revision="275945">The &man.elfdump.1; utility has been
+	updated to support capability mode provided by
+	&man.capsicum.4;.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-contrib">
+      <title>Contributed Software</title>
+
+      <para revision="277597"><application>OpenSSL</application> has
+	been updated to version 1.0.1l.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-installer">
+      <title>Installation and Configuration Tools</title>
+
+      <para>&nbsp;</para>
+    </sect2>
+
+    <sect2 xml:id="userland-rc">
+      <title><filename class="directory">/etc/rc.d</filename>
+	Scripts</title>
+
+      <para>&nbsp;</para>
+    </sect2>
+
+    <sect2 xml:id="userland-periodic">
+      <title><filename class="directory">/etc/periodic</filename>
+	Scripts</title>
+
+      <para>&nbsp;</para>
+    </sect2>
+
+    <sect2 xml:id="userland-libraries">
+      <title>Runtime Libraries and API</title>
+
+      <para revision="275040">A new file configuration library,
+	&man.figpar.3;, has been added to the base system.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-abi">
+      <title>ABI Compatibility</title>
+
+      <para>&nbsp;</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="kernel">
+    <title>Kernel</title>
+
+    <para>This section covers changes to kernel configurations, system
+      tuning, and system control parameters that are not otherwise
+      categorized.</para>
+
+    <sect2 xml:id="kernel-bugfix">
+      <title>Kernel Bug Fixes</title>
+
       <para>&nbsp;</para>
+    </sect2>
+
+    <sect2 xml:id="kernel-config">
+      <title>Kernel Configuration</title>
 
+      <para>&nbsp;</para>
     </sect2>
 
-    <sect2 xml:id="kernel">
-      <title>Kernel Changes</title>
+    <sect2 xml:id="kernel-sysctl">
+      <title>System Tuning and Controls</title>
 
       <para revision="276986">Throttling via <acronym>ACPI</acronym>
 	and <acronym>P4TCC</acronym> via &man.device.hints.5; have
 	been turned off by default.</para>
+    </sect2>
+  </sect1>
 
-      <sect3 xml:id="kernel-virtualization">
-	<title>Virtualization Support</title>
+  <sect1 xml:id="drivers">
+    <title>Devices and Drivers</title>
 
-	<para>&nbsp;</para>
-      </sect3>
+    <para>This section covers changes and additions to devices and
+      device drivers since &release.prev;.</para>
 
-      <sect3 xml:id="kernel-arm">
-	<title>ARM Support</title>
+    <sect2 xml:id="drivers-device">
+      <title>Device Drivers</title>
 
-	<para>&nbsp;</para>
-      </sect3>
+      <para>&nbsp;</para>
+    </sect2>
 
-      <sect3 xml:id="boot">
-	<title>Boot Loader Changes</title>
+    <sect2 xml:id="drivers-storage">
+      <title>Storage Drivers</title>
 
-	<para>&nbsp;</para>
-      </sect3>
+      <para>&nbsp;</para>
+    </sect2>
 
-      <sect3 xml:id="proc">
-	<title>Hardware Support</title>
+    <sect2 xml:id="drivers-network">
+      <title>Network Drivers</title>
 
-	<para>&nbsp;</para>
+      <para>&nbsp;</para>
+    </sect2>
+  </sect1>
 
-	<sect4 xml:id="mm">
-	  <title>Multimedia Support</title>
+  <sect1 xml:id="hardware">
+    <title>Hardware Support</title>
 
-	  <para>&nbsp;</para>
-	</sect4>
+    <para>This section covers general hardware support for physical
+      machines, hypervisors, and virtualization environments, as well
+      as hardware changes and updates that do not otherwise fit in
+      other sections of this document.</para>
 
-	<sect4 xml:id="net-if">
-	  <title>Network Interface Support</title>
+    <sect2 xml:id="hardware-support">
+      <title>Hardware Support</title>
 
-	  <para>&nbsp;</para>
-	</sect4>
-      </sect3>
+      <para>&nbsp;</para>
+    </sect2>
 
-      <sect3 xml:id="net-proto">
-	<title>Network Protocols</title>
+    <sect2 xml:id="hardware-virtualization">
+      <title>Virtualization Support</title>
 
-	<para>&nbsp;</para>
-      </sect3>
+      <para>&nbsp;</para>
+    </sect2>
 
-      <sect3 xml:id="disks">
-	<title>Disks and Storage</title>
+    <sect2 xml:id="hardware-arm">
+      <title>ARM Support</title>
 
-	<para revision="274939" contrib="sponsor" sponsor="&ix;">The
-	  &man.ctld.8; utility has been updated to include support for
-	  registering <acronym>iSCSI</acronym> targets and portals on
-	  <acronym>iSNS</acronym> servers.  This provides a mechanism
-	  which allows <acronym>iSCSI</acronym> initiators to find
-	  targets and portals without requiring active
-	  discovery.</para>
+      <para>&nbsp;</para>
+    </sect2>
+  </sect1>
 
-	<para revision="275891" contrib="sponsor" sponsor="&ix;">The
-	  &man.ctl.4; subsystem has been updated, increasing the ports
-	  limit from <literal>128</literal> to <literal>256</literal>,
-	  and <acronym>LUN</acronym> limit from <literal>256</literal>
-	  to <literal>1024</literal>.</para>
-      </sect3>
+  <sect1 xml:id="storage">
+    <title>Storage</title>
 
-      <sect3 xml:id="fs">
-	<title>File Systems</title>
+    <para>This section covers changes and additions to file systems
+      and other storage subsystems, both local and networked.</para>
 
-	<para revision="275490">A new tunable,
-	  <literal>vfs.zfs.spa_slop_shift</literal>, has been added,
-	  which controls how much space is reserved by default.</para>
-      </sect3>
+    <sect2 xml:id="storage-net">
+      <title>Networked Storage</title>
+
+      <para revision="274939" contrib="sponsor" sponsor="&ix;">The
+	&man.ctld.8; utility has been updated to include support for
+	registering <acronym>iSCSI</acronym> targets and portals on
+	<acronym>iSNS</acronym> servers.  This provides a mechanism
+	which allows <acronym>iSCSI</acronym> initiators to find
+	targets and portals without requiring active
+	discovery.</para>
     </sect2>
 
-    <sect2 xml:id="userland">
-      <title>Userland Changes</title>
+    <sect2 xml:id="storage-zfs">
+      <title>ZFS</title>
 
-      <para revision="275040">A new file configuration library,
-	&man.figpar.3;, has been added to the base system.</para>
+      <para revision="275490">A new tunable,
+	<literal>vfs.zfs.spa_slop_shift</literal>, has been added,
+	which controls how much space is reserved by default.</para>
+    </sect2>
 
-      <para revision="275040">A new utility, &man.dpv.1;, has been
-	added to the base system, providing a &man.dialog.1;-style
-	progress view from one or more input streams.  A corresponding
-	library, &man.dpv.3;, has also been added.</para>
+    <sect2 xml:id="storage-geom">
+      <title>&man.geom.4;</title>
 
-      <para revision="275945">The &man.elfdump.1; utility has been
-	updated to support capability mode provided by
-	&man.capsicum.4;.</para>
+      <para revision="275891" contrib="sponsor" sponsor="&ix;">The
+	&man.ctl.4; subsystem has been updated, increasing the ports
+	limit from <literal>128</literal> to <literal>256</literal>,
+	and <acronym>LUN</acronym> limit from <literal>256</literal>
+	to <literal>1024</literal>.</para>
+    </sect2>
+  </sect1>
 
-      <para revision="276991">The &man.termcap.5; file is installed
-	as-is from sources, instead of reordering, creating
-	<filename>/etc/termcap.db</filename> by default, providing
-	a performance improvements to applications that use the
-	&man.termcap.5; database, such as &man.vi.1; and
-	&man.ncurses.3;.</para>
+  <sect1 xml:id="boot">
+    <title>Boot Loader Changes</title>
 
-      <sect3 xml:id="rc-scripts">
-	<title><filename>/etc/rc.d</filename> Scripts</title>
+    <para>This section covers the boot loader, boot menu, and other
+      boot-related changes.</para>
 
-	<para>&nbsp;</para>
-      </sect3>
+    <sect2 xml:id="boot-loader">
+      <title>Boot Loader Changes</title>
+
+      <para>&nbsp;</para>
     </sect2>
 
-    <sect2 xml:id="contrib">
-      <title>Contributed Software</title>
+    <sect2 xml:id="boot-menu">
+      <title>Boot Menu Changes</title>
 
-      <para revision="277597"><application>OpenSSL</application> has
-	been updated to version 1.0.1l.</para>
+      <para>&nbsp;</para>
     </sect2>
+  </sect1>
+
+  <sect1 xml:id="network">
+    <title>Networking</title>
 
-    <sect2 xml:id="ports">
-      <title>Ports/Packages Collection Infrastructure</title>
+    <para>This section describes changes that affect networking in
+      &os;.</para>
+
+    <sect2 xml:id="network-protocols">
+      <title>Network Procols</title>
 
       <para>&nbsp;</para>
     </sect2>
+  </sect1>
+
+  <sect1 xml:id="ports">
+    <title>Ports Collection and Package Infrastructure</title>
 
-    <sect2 xml:id="releng">
-      <title>Release Engineering and Integration</title>
+    <para>This section covers changes to the &os;&nbsp;Ports
+      Collection, package infrastructure, and package maintenance and
+      installation tools.</para>
+
+    <sect2 xml:id="ports-infrastructure">
+      <title>Infrastructure Changes</title>
 
       <para>&nbsp;</para>
     </sect2>
 
-    <sect2 xml:id="doc">
-      <title>Documentation</title>
+    <sect2 xml:id="ports-packages ">
+      <title>Packaging Changes</title>
 
       <para>&nbsp;</para>
     </sect2>
   </sect1>
 
-  <sect1 xml:id="upgrade">
-    <title>Upgrading from Previous Releases of &os;</title>
+  <sect1 xml:id="doc">
+    <title>Documentation</title>
 
-    <para arch="amd64,i386">Binary upgrades between RELEASE versions
-      (and snapshots of the various security branches) are supported
-      using the &man.freebsd-update.8; utility.  The binary upgrade
-      procedure will update unmodified userland utilities, as well as
-      unmodified <filename>GENERIC</filename> kernel distributed as
-      a part of an official &os; release.  The &man.freebsd-update.8;
-      utility requires that the host being upgraded have Internet
-      connectivity.</para>
+    <para>This section covers changes to the &os;&nbsp;Documentation
+      Project sources and toolchain.</para>
 
-    <para>Source-based upgrades (those based on recompiling the &os;
-      base system from source code) from previous versions are
-      supported, according to the instructions in
-      <filename>/usr/src/UPDATING</filename>.</para>
+    <sect2 xml:id="doc-sources">
+      <title>Documentation Source Changes</title>
 
-    <important>
-      <para>Upgrading &os; should only be attempted after
-	backing up <emphasis>all</emphasis> data and configuration
-	files.</para>
-    </important>
+      <para>&nbsp;</para>
+    </sect2>
+
+    <sect2 xml:id="doc-toolchain">
+      <title>Documentation Toolchain Changes</title>
+
+      <para>&nbsp;</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="releng">
+    <title>Release Engineering and Integration</title>
+
+    <para>This section convers changes that are specific to the
+      &os;&nbsp;Release Engineering processes.</para>
+
+    <sect2 xml:id="releng-changes">
+      <title>Integration Changes</title>
+
+      <para>&nbsp;</para>
+    </sect2>
   </sect1>
 </article>