From f87ed05d1d3553494fb47df04b3bcb7749316b84 Mon Sep 17 00:00:00 2001
From: Jon Brisbin <jbrisbin@vmware.com>
Date: Sat, 2 Mar 2013 11:55:21 -0600
Subject: [PATCH] Update documentation.

---
 src/reference/docbook/index.xml           |  1 +
 src/reference/docbook/install.xml         | 26 ++++++++++++++
 src/reference/docbook/intro.xml           | 42 ++++++-----------------
 src/reference/docbook/representations.xml |  3 +-
 4 files changed, 40 insertions(+), 32 deletions(-)
 create mode 100644 src/reference/docbook/install.xml

diff --git a/src/reference/docbook/index.xml b/src/reference/docbook/index.xml
index 8db9786d3..357f56d7f 100644
--- a/src/reference/docbook/index.xml
+++ b/src/reference/docbook/index.xml
@@ -44,5 +44,6 @@
 
   <xi:include href="intro.xml"/>
   <xi:include href="representations.xml"/>
+  <xi:include href="install.xml"/>
 
 </book>
\ No newline at end of file
diff --git a/src/reference/docbook/install.xml b/src/reference/docbook/install.xml
new file mode 100644
index 000000000..e111f2690
--- /dev/null
+++ b/src/reference/docbook/install.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xml:id="install-chapter"
+         xmlns="http://docbook.org/ns/docbook"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://docbook.org/ns/docbook http://www.oasis-open.org/docbook/xml/5.0/xsd/docbook.xsd">
+
+  <title>Installing Spring Data REST</title>
+
+  <section>
+    <title>Adding Spring Data REST to an existing Spring MVC application</title>
+
+    <para>Spring Data REST is itself a Spring MVC application and is designed in such a way that it should integrate
+      with your existing Spring MVC applications with very little effort. An existing (or future) layer of services can
+      run alongside Spring Data REST with only minor considerations.
+    </para>
+
+    <para>To install Spring Data REST alongside your application, simply add the required dependencies, include the
+      stock
+      <code>@Configuration</code>
+      class (or subclass it and perform any required manual configuration), and map some URLs to be managed by Spring
+      Data REST.
+    </para>
+
+  </section>
+
+</chapter>
\ No newline at end of file
diff --git a/src/reference/docbook/intro.xml b/src/reference/docbook/intro.xml
index a391410aa..703718cb5 100644
--- a/src/reference/docbook/intro.xml
+++ b/src/reference/docbook/intro.xml
@@ -728,77 +728,57 @@ http://api.myservice.com/v1:>]]></programlisting>
         <tr>
           <td>
             <cmdsynopsis>
-              <command></command>
+              <command>put</command>
             </cmdsynopsis>
           </td>
           <td>
-            <para></para>
+            <para>HTTP PUT to the given path, passing JSON given in the --data parameter.</para>
           </td>
         </tr>
         <tr>
           <td>
             <cmdsynopsis>
-              <command></command>
+              <command>delete</command>
             </cmdsynopsis>
           </td>
           <td>
-            <para></para>
+            <para>HTTP DELETE to the given path.</para>
           </td>
         </tr>
         <tr>
           <td>
             <cmdsynopsis>
-              <command></command>
+              <command>auth basic</command>
             </cmdsynopsis>
           </td>
           <td>
-            <para></para>
+            <para>Set an HTTP Basic authentication token for use in this session.</para>
           </td>
         </tr>
         <tr>
           <td>
             <cmdsynopsis>
-              <command></command>
+              <command>auth clear</command>
             </cmdsynopsis>
           </td>
           <td>
-            <para></para>
+            <para>Clear the Authorization header currently in use.</para>
           </td>
         </tr>
         <tr>
           <td>
             <cmdsynopsis>
-              <command></command>
+              <command>ssl validate</command>
             </cmdsynopsis>
           </td>
           <td>
-            <para></para>
-          </td>
-        </tr>
-        <tr>
-          <td>
-            <cmdsynopsis>
-              <command></command>
-            </cmdsynopsis>
-          </td>
-          <td>
-            <para></para>
+            <para>Disable certificate checking to work with self-signed certificates.</para>
           </td>
         </tr>
       </table>
 
-
-      <para>
-        get - HTTP GET from the given path.
-        post - HTTP POST to the given path, passing JSON given in the --data parameter.
-        put - HTTP PUT to the given path, passing JSON given in the --data parameter.
-        delete - HTTP DELETE to the given path.
-        auth basic - Set an HTTP Basic authentication token for use in this session.
-        auth clear - Clear the Authorization header currently in use.
-        ssl validate - Disable certificate checking to work with self-signed certificates.
-      </para>
-
     </section>
+
   </section>
 
 </chapter>
\ No newline at end of file
diff --git a/src/reference/docbook/representations.xml b/src/reference/docbook/representations.xml
index 18d6c2b28..6133a7ade 100644
--- a/src/reference/docbook/representations.xml
+++ b/src/reference/docbook/representations.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<chapter xml:id="intro-chapter"
+<chapter xml:id="representations-chapter"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://docbook.org/ns/docbook http://www.oasis-open.org/docbook/xml/5.0/xsd/docbook.xsd">
@@ -26,6 +26,7 @@
           content-type.
         </para>
       </footnote>
+
     </para>
   </section>