bdr: doc: move the preface into the book abstract

diff --git a/doc/bdr.sgml b/doc/bdr.sgml
index f7253f042fa5b43058a0ae2927a1ad74ecf124fb..a759ce68308803e0e08fe5a7aa339d49ffa4a2f6 100644 (file)
--- a/doc/bdr.sgml
+++ b/doc/bdr.sgml
@@ -21,27 +21,61 @@
   <productname>BDR</productname>
   <productnumber>&bdrversion;</productnumber>
   &legal;
- </bookinfo>
-
- <preface id="preface">
-  <title>Preface</title>
-
-  <para>
+  <!--
+
+   This should be restored once we have a stylesheet that makes the
+   authorgroup display less prominent on the page.
+
+  <authorgroup>
+   <author>
+    <firstname>Andres</firstname><surname>Freund</surname>
+   </author>
+   <author>
+    <firstname>Petr</firstname><surname>Jelinek</surname>
+   </author>
+   <author>
+    <firstname>Craig</firstname><surname>Ringer</surname>
+   </author>
+  </authorgroup>
+  -->
+  <abstract>
+   <para>
    This book is the official documentation of &bdr; &bdrversion; for
    use with PostgreSQL &pgmajorversion;. It has been written by the
    &postgres; and &bdr; developers and other volunteers in parallel to
    the development of the &bdr; software.  It describes all the
    functionality that the current version of &bdr; officially
    supports.
-  </para>
- </preface>
+   </para>
+  </abstract>
+  <keywordset>
+   <keyword>BDR</keyword>
+   <keyword>UDR</keyword>
+   <keyword>PostgreSQL</keyword>
+   <keyword>replication</keyword>
+   <keyword>asynchronous</keyword>
+   <keyword>multi-master</keyword>
+   <keyword>high-availability</keyword>
+   <keyword>scalability</keyword>
+  </keywordset>
+ </bookinfo>
 
  <part id="installation">
   <title>Installation</title>
 
   <partintro>
    <para>
-    There are several options for installing both &bdr; and &udr;.
+    It is possible to install &bdr; or &udr; from binary packages or from
+    source.
+   </para>
+   <para>
+    In general you should choose binary packages if they are available
+    for your platform.
+   </para>
+   <para>
+    Source installs are mainly useful if you want to keep track of the very
+    latest BDR development and contribute to development.  They're also the
+    only option if there are no packages for your operating system yet.
    </para>
   </partintro>