FAQ Introduction and Abstract

Eitan Adler lists at eitanadler.com
Fri Mar 15 00:39:19 UTC 2013


Anyone have thoughts on the following?

commit 77849693306b6dc0698ac45a4173d43f419e97e9
Author: Eitan Adler <lists at 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; - and &rel.relx; -
-      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


More information about the freebsd-doc mailing list