The Books and Articles section was very choppy due to its cut-and-paste

origins and prior edits.  Polish it.

1 files changed, 31 insertions, 38 deletions

diff --git a/release/doc/en_US.ISO8859-1/readme/article.sgml b/release/doc/en_US.ISO8859-1/readme/article.sgml
index ddbeef8..f766a5f 100644
--- a/release/doc/en_US.ISO8859-1/readme/article.sgml
+++ b/release/doc/en_US.ISO8859-1/readme/article.sgml
@@ -87,7 +87,7 @@
 
       <para>The basic requirements for using this &release.type are
 	technical proficiency with &os; and an understanding of the
-	ongoing development process of &os; &release.current; (as
+	ongoing development process of &os; &release.branch; (as
 	discussed on the &a.current;).</para>
 
       <para>For those more interested in doing business with &os; than
@@ -174,7 +174,7 @@
       <para>For any questions or general technical support issues,
 	please send mail to the &a.questions;.</para>
 
-      <para>If you're tracking the -current development efforts, you
+      <para>If you're tracking the &release.branch; development efforts, you
 	<emphasis>must</emphasis> join the &a.current;, in order to
 	keep abreast of recent developments and changes that may
 	affect the way you use and maintain the system.
@@ -298,42 +298,10 @@
 	</itemizedlist>
       </para>
 
-      <para>Most information is also available from the Documentation
-	menu during installation.</para>
-    </sect2>
-
-    <sect2>
-      <title>Books and Articles</title>
-
-      <para>Pointers to more documentation on &os; can be found in the
-	<ulink
-	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books
-	&amp; Magazines Specific to FreeBSD</ulink> section of the
-	&os; Handbook.  Because of &os;'s strong UNIX heritage, many
-	other articles and books written for UNIX systems are
-	applicable as well.  A selection of these documents can be
-	found in the Handbook's <ulink
-	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>.
-      </para>
-
-      <para>If you're new to &os; then you should also read all of the
-	documentation files listed in <xref linkend="release-docs">,
-	all of which are available from the Documentation menu in the
-	installation program.  It may seem like a lot to read, but
-	it's important to at least acquaint yourself with the types of
-	information available, should you run into problems later.
-	Once the system is installed, you can also revisit this menu
-	by running the &man.sysinstall.8; utility.</para>
-
-      <para>On-line versions of the <ulink
-	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
-	(Frequently Asked Questions document) and <ulink
-	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink>
-	are always available from the <ulink
-	url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
-	page</ulink> or its mirrors.  If you install the
-	<filename>doc</filename> distribution set, you can use a Web
-	browser to read the FAQ and Handbook locally.</para>
+      <para>Most of this information is also available from the
+	Documentation menu during installation.  Once the system is
+	installed, you can revisit this menu by running the
+	&man.sysinstall.8; utility.</para>
 
       <note>
 	<para>It is extremely important to read the errata for any
@@ -349,6 +317,31 @@
 	  location).</para>
       </note>
     </sect2>
+
+    <sect2>
+      <title>Books and Articles</title>
+
+      <para>Two highly-useful collections of &os;-related information,
+	maintained by the &os; Project,
+	are the &os; Handbook and &os; FAQ (Frequently Asked
+	Questions document).  On-line versions of the <ulink
+	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink>
+	and <ulink
+	url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
+	are always available from the <ulink
+	url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
+	page</ulink> or its mirrors.  If you install the
+	<filename>doc</filename> distribution set, you can use a Web
+	browser to read the Handbook and FAQ locally.</para>
+
+      <para>A listing of books and other documents about &os; can be
+        found in the <ulink
+        url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">bibliography</ulink>
+        of the &os; Handbook.  Because of &os;'s strong UNIX heritage,
+        many other articles and books written for UNIX systems are
+        applicable as well, some of which are also listed in the
+        bibliography.</para>
+    </sect2>
   </sect1>
 
   <sect1>