Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 14 Mar 2013 20:38:42 -0400
From:      Eitan Adler <lists@eitanadler.com>
To:        freebsd-doc@freebsd.org
Subject:   FAQ Introduction and Abstract
Message-ID:  <CAF6rxgmPp0YpvHuK65zWiX9Ha0xMOq4XYSiQNAysXLH5VpP3BQ@mail.gmail.com>

next in thread | raw e-mail | index | archive | help
Anyone have thoughts on the following?

commit 77849693306b6dc0698ac45a4173d43f419e97e9
Author: Eitan Adler <lists@eitanadler.com>
Date:   Thu Mar 14 20:37:13 2013 -0400

    Remove duplicate text from the introduction and move it into the
    abstract.  Simplify some of the text from both sections.

    Reviewed by:	doc
    Approved by:	??? (mentor)

diff --git a/en_US.ISO8859-1/books/faq/book.xml
b/en_US.ISO8859-1/books/faq/book.xml
index 8c93f05..df5fa00 100644
--- a/en_US.ISO8859-1/books/faq/book.xml
+++ b/en_US.ISO8859-1/books/faq/book.xml
@@ -73,39 +73,26 @@
     <releaseinfo>$FreeBSD$</releaseinfo>

     <abstract>
-      <para>This is the FAQ for &os; versions
-	&rel2.relx; and &rel.relx;.
-	If you are interested in helping with
-	this project, send email to the &a.doc;.  The latest version of
+      <para>This is the FAQ for &os; versions &rel2.relx; and
+	&rel.relx;. Every effort has been made to make this FAQ as
+	informative as possible; if you have any suggestions as to how
+	it may be improved, please feel free to mail them to the
+	&a.doc;.</para>
+
+      <para>The latest version of
 	this document is always available from the <ulink
 	  url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/index.html">&os;
website</ulink>.
 	It may also be downloaded as one large <ulink
 	  url="book.html">HTML</ulink> file with HTTP or as a variety
 	of other formats from the <ulink
 	  url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP
-	server</ulink>.  You may also want to <ulink
-	  url="&url.base;/search/index.html">Search the FAQ</ulink>.</para>
+	server</ulink>.</para>
     </abstract>
   </bookinfo>

   <chapter id="introduction">
     <title>Introduction</title>

-    <para>Welcome to the &os;
-      &rel2.relx;&nbsp;- and &rel.relx;&nbsp;-
-      FAQ!</para>
-
-    <para>As is usual with Usenet FAQs, this document aims to cover the
-      most frequently asked questions concerning the &os; operating
-      system (and of course answer them!).  Although originally intended
-      to reduce bandwidth and avoid the same old questions being asked
-      over and over again, FAQs have become recognized as valuable
-      information resources.</para>
-
-    <para>Every effort has been made to make this FAQ as informative as
-      possible; if you have any suggestions as to how it may be
-      improved, please feel free to mail them to the &a.doc;.</para>
-
     <qandaset>
       <qandaentry>
 	<question id="what-is-FreeBSD">


-- 
Eitan Adler



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAF6rxgmPp0YpvHuK65zWiX9Ha0xMOq4XYSiQNAysXLH5VpP3BQ>