From 347724780ac0c8fbf7e8437620b576c8038e676e Mon Sep 17 00:00:00 2001
From: Lana Brindley <openstack@lanabrindley.com>
Date: Fri, 8 Aug 2014 22:20:52 +1000
Subject: [PATCH] Creation of book structure for Networking Guide

Change-Id: Ib4aab29234654946afe42dfe31a96fe3f4a55cdc
---
 doc/local-files.html                          |  5 ++
 doc/networking-guide/bk-networking.xml        | 65 +++++++++++++++
 doc/networking-guide/ch_advanced.xml          | 16 ++++
 doc/networking-guide/ch_debugging.xml         | 16 ++++
 doc/networking-guide/ch_deployment.xml        | 16 ++++
 doc/networking-guide/ch_intro.xml             | 20 +++++
 .../ch_networking-architecture.xml            | 16 ++++
 .../ch_networking-data-model.xml              | 20 +++++
 doc/networking-guide/ch_plugins.xml           | 16 ++++
 doc/networking-guide/ch_scalability-HA.xml    | 16 ++++
 doc/networking-guide/pom.xml                  | 79 +++++++++++++++++++
 doc/networking-guide/roadmap.rst              |  8 ++
 doc/pom.xml                                   |  1 +
 13 files changed, 294 insertions(+)
 create mode 100644 doc/networking-guide/bk-networking.xml
 create mode 100644 doc/networking-guide/ch_advanced.xml
 create mode 100644 doc/networking-guide/ch_debugging.xml
 create mode 100644 doc/networking-guide/ch_deployment.xml
 create mode 100644 doc/networking-guide/ch_intro.xml
 create mode 100644 doc/networking-guide/ch_networking-architecture.xml
 create mode 100644 doc/networking-guide/ch_networking-data-model.xml
 create mode 100644 doc/networking-guide/ch_plugins.xml
 create mode 100644 doc/networking-guide/ch_scalability-HA.xml
 create mode 100644 doc/networking-guide/pom.xml
 create mode 100644 doc/networking-guide/roadmap.rst

diff --git a/doc/local-files.html b/doc/local-files.html
index 84ca4b825f..09a21d56c7 100644
--- a/doc/local-files.html
+++ b/doc/local-files.html
@@ -93,6 +93,11 @@
        High Availability Guide
       </a>
      </dd>
+     <dd>
+      <a href="networking-guide/target/docbkx/webhelp/networking-guide/content/index.html">
+       Networking Guide
+      </a>
+     </dd>
      <dd>
       <a href="image-guide/target/docbkx/webhelp/image-guide/content/index.html">
        Virtual Machine Image Guide
diff --git a/doc/networking-guide/bk-networking.xml b/doc/networking-guide/bk-networking.xml
new file mode 100644
index 0000000000..d5c7b0a8db
--- /dev/null
+++ b/doc/networking-guide/bk-networking.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<book xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
+    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+    xml:id="openstack-networking-juno">
+    <title>OpenStack Networking Guide</title>
+    <?rax title.font.size="28px" subtitle.font.size="28px"?>
+    <titleabbrev>Networking Guide</titleabbrev>
+    <info>
+        <author>
+            <personname>
+                <firstname/>
+                <surname/>
+            </personname>
+            <affiliation>
+                <orgname>OpenStack Foundation</orgname>
+            </affiliation>
+        </author>
+        <copyright>
+            <year>2014</year>
+            <holder>OpenStack Foundation</holder>
+        </copyright>
+        <releaseinfo>current</releaseinfo>
+        <productname>OpenStack</productname>
+        <pubdate/>
+        <legalnotice role="apache2">
+            <annotation>
+                <remark>Copyright details are filled in by the template.</remark>
+            </annotation>
+        </legalnotice>
+        <legalnotice role="cc-by-sa">
+            <annotation>
+                <remark>Remaining licensing details are filled in by the template.</remark>
+            </annotation>
+        </legalnotice>
+        <abstract>
+            <para>OpenStack offers open source software for cloud administrators to manage and
+                troubleshoot an OpenStack cloud.</para>
+        </abstract>
+        <revhistory>
+            <!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
+            <revision>
+                <date>2014-08-08</date>
+                <revdescription>
+                    <itemizedlist>
+                        <listitem>
+                            <para>Creation of document.</para>
+                        </listitem>
+                    </itemizedlist>
+                </revdescription>
+            </revision>
+        </revhistory>
+    </info>
+    <!-- Chapters are referred from the book file through these include statements. You can add additional chapters using these types of statements. -->
+    <xi:include href="../common/ch_preface.xml"/>
+    <xi:include href="../common/ch_getstart.xml"/>
+    <xi:include href="ch_intro.xml"/>
+    <xi:include href="ch_networking-data-model.xml"/>
+    <xi:include href="ch_networking-architecture.xml"/>
+    <xi:include href="ch_plugins.xml"/>
+    <xi:include href="ch_deployment.xml"/>
+    <xi:include href="ch_scalability-HA.xml"/>
+    <xi:include href="ch_advanced.xml"/>
+    <xi:include href="ch_debugging.xml"/>
+    <xi:include href="../common/app_support.xml"/>
+</book>
diff --git a/doc/networking-guide/ch_advanced.xml b/doc/networking-guide/ch_advanced.xml
new file mode 100644
index 0000000000..139c985902
--- /dev/null
+++ b/doc/networking-guide/ch_advanced.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_advanced">
+    <title>Advanced configuration options</title>
+      <para>
+        Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+        bresaola pork belly beef ribs ham hock capicola tail prosciutto
+        landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+        boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+        ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+        shankle bresaola cow filet mignon ham hock shank.
+      </para>
+</chapter>
diff --git a/doc/networking-guide/ch_debugging.xml b/doc/networking-guide/ch_debugging.xml
new file mode 100644
index 0000000000..e29c7b62fc
--- /dev/null
+++ b/doc/networking-guide/ch_debugging.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_debugging">
+    <title>Debugging</title>
+      <para>
+        Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+        bresaola pork belly beef ribs ham hock capicola tail prosciutto
+        landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+        boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+        ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+        shankle bresaola cow filet mignon ham hock shank.
+      </para>
+</chapter>
diff --git a/doc/networking-guide/ch_deployment.xml b/doc/networking-guide/ch_deployment.xml
new file mode 100644
index 0000000000..e354052fb3
--- /dev/null
+++ b/doc/networking-guide/ch_deployment.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_deployment">
+    <title>Deployment</title>
+      <para>
+        Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+        bresaola pork belly beef ribs ham hock capicola tail prosciutto
+        landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+        boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+        ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+        shankle bresaola cow filet mignon ham hock shank.
+      </para>
+</chapter>
diff --git a/doc/networking-guide/ch_intro.xml b/doc/networking-guide/ch_intro.xml
new file mode 100644
index 0000000000..ebcde72038
--- /dev/null
+++ b/doc/networking-guide/ch_intro.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter [
+<!ENTITY % openstack SYSTEM "../common/entities/openstack.ent">
+%openstack;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="networking-intro">
+    <title>Introduction to networking</title>
+    <para>
+      Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+      bresaola pork belly beef ribs ham hock capicola tail prosciutto
+      landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+      boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+      ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+      shankle bresaola cow filet mignon ham hock shank.
+    </para>
+</chapter>
diff --git a/doc/networking-guide/ch_networking-architecture.xml b/doc/networking-guide/ch_networking-architecture.xml
new file mode 100644
index 0000000000..b6e5ced079
--- /dev/null
+++ b/doc/networking-guide/ch_networking-architecture.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    version="5.0"
+    xml:id="ch_networking-architecture">
+    <title>Networking architecture</title>
+        <para>
+          Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+          bresaola pork belly beef ribs ham hock capicola tail prosciutto
+          landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+          boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+          ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+          shankle bresaola cow filet mignon ham hock shank.
+        </para>
+</chapter>
diff --git a/doc/networking-guide/ch_networking-data-model.xml b/doc/networking-guide/ch_networking-data-model.xml
new file mode 100644
index 0000000000..2651fbaf07
--- /dev/null
+++ b/doc/networking-guide/ch_networking-data-model.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter [
+<!ENTITY % openstack SYSTEM "../common/entities/openstack.ent">
+%openstack;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_networking-data-model">
+    <title>Networking data model</title>
+       <para>
+        Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+        bresaola pork belly beef ribs ham hock capicola tail prosciutto
+        landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+        boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+        ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+        shankle bresaola cow filet mignon ham hock shank.
+      </para>
+</chapter>
diff --git a/doc/networking-guide/ch_plugins.xml b/doc/networking-guide/ch_plugins.xml
new file mode 100644
index 0000000000..8e5483a758
--- /dev/null
+++ b/doc/networking-guide/ch_plugins.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch-plugins">
+  <title>Plugins</title>
+    <para>
+      Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+      bresaola pork belly beef ribs ham hock capicola tail prosciutto
+      landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+      boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+      ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+      shankle bresaola cow filet mignon ham hock shank.
+    </para>
+</chapter>
diff --git a/doc/networking-guide/ch_scalability-HA.xml b/doc/networking-guide/ch_scalability-HA.xml
new file mode 100644
index 0000000000..603d7edaf7
--- /dev/null
+++ b/doc/networking-guide/ch_scalability-HA.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  version="5.0"
+  xml:id="ch_scalability-HA">
+    <title>Scalability and high availability</title>
+       <para>
+        Bacon ipsum dolor sit amet biltong meatloaf andouille, turducken
+        bresaola pork belly beef ribs ham hock capicola tail prosciutto
+        landjaeger meatball pork loin. Swine turkey jowl, porchetta doner
+        boudin meatloaf. Shoulder capicola prosciutto, shank landjaeger short
+        ribs sirloin turducken pork belly boudin frankfurter chuck. Salami
+        shankle bresaola cow filet mignon ham hock shank.
+      </para>
+</chapter>
diff --git a/doc/networking-guide/pom.xml b/doc/networking-guide/pom.xml
new file mode 100644
index 0000000000..7822fd8fec
--- /dev/null
+++ b/doc/networking-guide/pom.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <parent>
+        <groupId>org.openstack.docs</groupId>
+        <artifactId>parent-pom</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>openstack-networking-guide</artifactId>
+    <packaging>jar</packaging>
+    <name>OpenStack Networking Guide</name>
+    <properties>
+        <!-- This is set by Jenkins according to the branch. -->
+        <release.path.name></release.path.name>
+        <comments.enabled>0</comments.enabled>
+    </properties>
+    <!-- ################################################ -->
+    <!-- USE "mvn clean generate-sources" to run this POM -->
+    <!-- ################################################ -->
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.rackspace.cloud.api</groupId>
+                <artifactId>clouddocs-maven-plugin</artifactId>
+                <!-- version set in ../pom.xml -->
+                <executions>
+                    <execution>
+                        <id>generate-webhelp</id>
+                        <goals>
+                            <goal>generate-webhelp</goal>
+                        </goals>
+                        <phase>generate-sources</phase>
+                        <configuration>
+                            <!-- These parameters only apply to webhelp -->
+                            <enableDisqus>0</enableDisqus>
+                            <disqusShortname>os-networking-guide</disqusShortname>
+                            <enableGoogleAnalytics>1</enableGoogleAnalytics>
+                            <googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
+                            <generateToc>
+                                appendix  toc,title
+                                article/appendix  nop
+                                article   toc,title
+                                book      toc,title,figure,table,example,equation
+                                chapter   toc,title
+                                section   toc
+                                part      toc,title
+                                qandadiv  toc
+                                qandaset  toc
+                                reference toc,title
+                                set       toc,title
+                            </generateToc>
+                            <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
+                            <sectionAutolabel>0</sectionAutolabel>
+                            <tocSectionDepth>1</tocSectionDepth>
+                            <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
+                            <webhelpDirname>networking-guide</webhelpDirname>
+                            <pdfFilenameBase>networking-guide</pdfFilenameBase>
+                        </configuration>
+                    </execution>
+                </executions>
+                <configuration>
+                    <!-- These parameters apply to pdf and webhelp -->
+                    <xincludeSupported>true</xincludeSupported>
+                    <sourceDirectory>.</sourceDirectory>
+                    <includes>
+                        bk-networking.xml
+                    </includes>
+                    <canonicalUrlBase>http://docs.openstack.org/networking-guide/content</canonicalUrlBase>
+                    <glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
+                    <branding>openstack</branding>
+                    <formalProcedures>0</formalProcedures>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/doc/networking-guide/roadmap.rst b/doc/networking-guide/roadmap.rst
new file mode 100644
index 0000000000..247f4a2f9b
--- /dev/null
+++ b/doc/networking-guide/roadmap.rst
@@ -0,0 +1,8 @@
+Roadmap for Networking Guide
+-----------------------------
+
+This file is stored with the source to offer ideas for what to work on.
+Put your name next to a task if you want to work on it and put a WIP
+review up on review.openstack.org.
+
+TBD
diff --git a/doc/pom.xml b/doc/pom.xml
index ec343e9659..1d18bbd694 100644
--- a/doc/pom.xml
+++ b/doc/pom.xml
@@ -18,6 +18,7 @@
     <module>high-availability-guide</module>
     <module>image-guide</module>
     <module>install-guide</module>
+    <module>networking-guide</module>
     <module>user-guide</module>
     <module>user-guide-admin</module>
   </modules>