From c7e8a035dd31c2fd232bfcd7c13fb0d2d2c6337e Mon Sep 17 00:00:00 2001
From: David Montag <david.montag@neotechnology.com>
Date: Thu, 10 Mar 2011 22:37:40 -0800
Subject: [PATCH] First step toward guidebook style documentation.

---
 src/docbkx/about-book.xml                     |  6 ++
 src/docbkx/index.xml                          | 68 ++++++++++++++-----
 src/docbkx/{ => reference}/cross-store.xml    |  0
 src/docbkx/{ => reference}/neo4j.xml          |  0
 src/docbkx/{ => reference}/preface.xml        |  0
 .../{ => reference}/programming-model.xml     |  0
 src/docbkx/{ => reference}/samples.xml        |  0
 src/docbkx/{ => reference}/setup.xml          |  0
 src/docbkx/tutorial/about-spring-data.xml     |  6 ++
 src/docbkx/tutorial/about-tutorial.xml        |  6 ++
 src/docbkx/tutorial/annotations.xml           |  6 ++
 src/docbkx/tutorial/data-access.xml           |  6 ++
 src/docbkx/tutorial/domain.xml                |  6 ++
 src/docbkx/tutorial/recommendations.xml       |  6 ++
 src/docbkx/tutorial/security.xml              |  6 ++
 src/docbkx/tutorial/setup.xml                 |  6 ++
 src/docbkx/tutorial/social.xml                |  6 ++
 17 files changed, 110 insertions(+), 18 deletions(-)
 create mode 100644 src/docbkx/about-book.xml
 rename src/docbkx/{ => reference}/cross-store.xml (100%)
 rename src/docbkx/{ => reference}/neo4j.xml (100%)
 rename src/docbkx/{ => reference}/preface.xml (100%)
 rename src/docbkx/{ => reference}/programming-model.xml (100%)
 rename src/docbkx/{ => reference}/samples.xml (100%)
 rename src/docbkx/{ => reference}/setup.xml (100%)
 create mode 100644 src/docbkx/tutorial/about-spring-data.xml
 create mode 100644 src/docbkx/tutorial/about-tutorial.xml
 create mode 100644 src/docbkx/tutorial/annotations.xml
 create mode 100644 src/docbkx/tutorial/data-access.xml
 create mode 100644 src/docbkx/tutorial/domain.xml
 create mode 100644 src/docbkx/tutorial/recommendations.xml
 create mode 100644 src/docbkx/tutorial/security.xml
 create mode 100644 src/docbkx/tutorial/setup.xml
 create mode 100644 src/docbkx/tutorial/social.xml

diff --git a/src/docbkx/about-book.xml b/src/docbkx/about-book.xml
new file mode 100644
index 000000000..b3ca500e2
--- /dev/null
+++ b/src/docbkx/about-book.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<para>
+    foo
+
+</para>
diff --git a/src/docbkx/index.xml b/src/docbkx/index.xml
index 692811e82..0fe4edb75 100644
--- a/src/docbkx/index.xml
+++ b/src/docbkx/index.xml
@@ -1,9 +1,9 @@
-<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
-        "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <book xmlns:xi="http://www.w3.org/2001/XInclude">
 
     <bookinfo>
-        <title>Spring Data Graph - Reference Documentation</title>
+        <title>The Spring Data Graph Guidebook</title>
         <releaseinfo>&version;</releaseinfo>
 
         <authorgroup>
@@ -37,28 +37,60 @@
 
     <toc/>
 
-  <part id="introduction">
-    <title>Introduction</title>
+    <preface id="foreword:rod">
+        <title>Foreword: Rod Johnson, CEO of SpringSource</title>
+        <para>
+            Rod ...
+        </para>
+    </preface>
 
-    <xi:include href="introduction/introduction.xml"/>
-    <xi:include href="introduction/why-sd-graph.xml"/>
-    <xi:include href="introduction/requirements.xml"/>
-    <xi:include href="introduction/get-started.xml"/>
-  </part>
+    <preface id="foreword:emil">
+        <title>Foreword: Emil Eifrem, CEO of Neo Technology</title>
+        <para>
+            Emil ...
+        </para>
+    </preface>
+
+    <preface id="about-book">
+        <title>About this book</title>
+        <para>
+            Duplex book ...
+        </para>
+    </preface>
+
+    <part id="tutorial">
+        <title>Tutorial</title>
+        <partintro>
+            <para>
+                Tutorial intro ...
+            </para>
+        </partintro>
+
+        <xi:include href="tutorial/about-spring-data.xml"/>
+        <xi:include href="tutorial/about-tutorial.xml"/>
+        <xi:include href="tutorial/setup.xml"/>
+        <xi:include href="tutorial/domain.xml"/>
+        <xi:include href="tutorial/annotations.xml"/>
+        <xi:include href="tutorial/data-access.xml"/>
+        <xi:include href="tutorial/security.xml"/>
+        <xi:include href="tutorial/social.xml"/>
+        <xi:include href="tutorial/recommendations.xml"/>
+    </part>
 
     <part id="reference">
         <title>Reference</title>
         <partintro>
             <para>
-                This part of the reference documentation details the API, concepts, annotations, datastore, programming model and 
-				the cross-store approach of Spring Data Graph.
+                This is the reference part of the book. It has information about the programming model, APIs,
+                concepts, and annotations of Spring Data Graph.
             </para>
         </partintro>
-	    <xi:include href="preface.xml"/>
-	    <xi:include href="neo4j.xml"/>
-	    <xi:include href="programming-model.xml"/>
-	    <xi:include href="setup.xml"/>
-	    <xi:include href="cross-store.xml"/>
-        <xi:include href="samples.xml"/>
+
+        <xi:include href="reference/preface.xml"/>
+        <xi:include href="reference/neo4j.xml"/>
+        <xi:include href="reference/programming-model.xml"/>
+        <xi:include href="reference/setup.xml"/>
+        <xi:include href="reference/cross-store.xml"/>
+        <xi:include href="reference/samples.xml"/>
     </part>
 </book>
diff --git a/src/docbkx/cross-store.xml b/src/docbkx/reference/cross-store.xml
similarity index 100%
rename from src/docbkx/cross-store.xml
rename to src/docbkx/reference/cross-store.xml
diff --git a/src/docbkx/neo4j.xml b/src/docbkx/reference/neo4j.xml
similarity index 100%
rename from src/docbkx/neo4j.xml
rename to src/docbkx/reference/neo4j.xml
diff --git a/src/docbkx/preface.xml b/src/docbkx/reference/preface.xml
similarity index 100%
rename from src/docbkx/preface.xml
rename to src/docbkx/reference/preface.xml
diff --git a/src/docbkx/programming-model.xml b/src/docbkx/reference/programming-model.xml
similarity index 100%
rename from src/docbkx/programming-model.xml
rename to src/docbkx/reference/programming-model.xml
diff --git a/src/docbkx/samples.xml b/src/docbkx/reference/samples.xml
similarity index 100%
rename from src/docbkx/samples.xml
rename to src/docbkx/reference/samples.xml
diff --git a/src/docbkx/setup.xml b/src/docbkx/reference/setup.xml
similarity index 100%
rename from src/docbkx/setup.xml
rename to src/docbkx/reference/setup.xml
diff --git a/src/docbkx/tutorial/about-spring-data.xml b/src/docbkx/tutorial/about-spring-data.xml
new file mode 100644
index 000000000..10c971d14
--- /dev/null
+++ b/src/docbkx/tutorial/about-spring-data.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:about-spring-data">
+    <title>About Spring Data</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/about-tutorial.xml b/src/docbkx/tutorial/about-tutorial.xml
new file mode 100644
index 000000000..a06352fb7
--- /dev/null
+++ b/src/docbkx/tutorial/about-tutorial.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:about-tutorial">
+    <title>About this tutorial</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/annotations.xml b/src/docbkx/tutorial/annotations.xml
new file mode 100644
index 000000000..d14a4e17c
--- /dev/null
+++ b/src/docbkx/tutorial/annotations.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:annotations">
+    <title>Annotating the domain model</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/data-access.xml b/src/docbkx/tutorial/data-access.xml
new file mode 100644
index 000000000..28067b4a3
--- /dev/null
+++ b/src/docbkx/tutorial/data-access.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:data-access">
+    <title>Accessing the data</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/domain.xml b/src/docbkx/tutorial/domain.xml
new file mode 100644
index 000000000..f2eae9a40
--- /dev/null
+++ b/src/docbkx/tutorial/domain.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:domain">
+    <title>The domain</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/recommendations.xml b/src/docbkx/tutorial/recommendations.xml
new file mode 100644
index 000000000..46fb6698c
--- /dev/null
+++ b/src/docbkx/tutorial/recommendations.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:recommendations">
+    <title>Adding recommendations</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/security.xml b/src/docbkx/tutorial/security.xml
new file mode 100644
index 000000000..2f8da73e5
--- /dev/null
+++ b/src/docbkx/tutorial/security.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:security">
+    <title>Adding security</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/setup.xml b/src/docbkx/tutorial/setup.xml
new file mode 100644
index 000000000..86ec3a4f8
--- /dev/null
+++ b/src/docbkx/tutorial/setup.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:setup">
+    <title>Project setup</title>
+    <para>foo</para>
+</chapter>
diff --git a/src/docbkx/tutorial/social.xml b/src/docbkx/tutorial/social.xml
new file mode 100644
index 000000000..12b1201ad
--- /dev/null
+++ b/src/docbkx/tutorial/social.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="tutorial:social">
+    <title>Adding social</title>
+    <para>foo</para>
+</chapter>