Small editorial changes to the template documents.

Added reference sections without local placeholders.
Restructured the user-guide index template.

Change-Id: I8b2e6abbe151a8fb9f3721e761a65f70fada1e85
Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>

8 files changed, 51 insertions, 34 deletions

diff --git a/docs/userguide/abstract.rst b/docs/userguide/abstract.rst
new file mode 100644
index 000000000..b7b22aa5b
--- /dev/null
+++ b/docs/userguide/abstract.rst
@@ -0,0 +1,8 @@
+Abstract
+--------
+
+This document provides guidance and instructions for using
+features delivered in the Brahmaputra release of OPNFV.
+
+This document provides a guide for the usage of features and the
+needed selection of tools and components as prerequisites.
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index c78dd8624..6aea80894 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -6,15 +6,22 @@
 Welcome to OPNFV User Guide
 ===========================
 
-This guide seeks to inform operators how to use the OPNFV Platform and its components to enable platform
-features provided in the Brahmaputra release.
+.. toctree::
+   :maxdepth: 2
+
+   abstract.rst
+   introduction.rst
 
-Contents:
+General system usage
+====================
 
 .. toctree::
    :maxdepth: 2
 
-   userguide.rst
+   openstack.rst
+   opendaylight.rst
+   onos.rst
+   ovs.rst
 
 Using Brahmaputra Features
 ==========================
diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst
new file mode 100644
index 000000000..a492c6efb
--- /dev/null
+++ b/docs/userguide/introduction.rst
@@ -0,0 +1,4 @@
+OPNFV User Guide
+================
+
+Outline the structure and composition of the User Guide in this section.
diff --git a/docs/userguide/onos.rst b/docs/userguide/onos.rst
new file mode 100644
index 000000000..0806caae5
--- /dev/null
+++ b/docs/userguide/onos.rst
@@ -0,0 +1,7 @@
+ONOS User Guide
+=======================
+
+Add ONOS specific user guide information here.
+Needs to include OPNFV default ports and addresses and
+references to upstream documentation applicable for an
+OPNFV deployment.
diff --git a/docs/userguide/opendaylight.rst b/docs/userguide/opendaylight.rst
new file mode 100644
index 000000000..6e43c05c5
--- /dev/null
+++ b/docs/userguide/opendaylight.rst
@@ -0,0 +1,7 @@
+OpenDaylight User Guide
+=======================
+
+Add opendaylight specific user guide information here.
+Needs to include OPNFV default ports and addresses and
+references to upstream documentation applicable for an
+OPNFV deployment.
diff --git a/docs/userguide/openstack.rst b/docs/userguide/openstack.rst
new file mode 100644
index 000000000..daeb5240f
--- /dev/null
+++ b/docs/userguide/openstack.rst
@@ -0,0 +1,7 @@
+OpenStack User Guide
+====================
+
+Add openstack specific user guide information here.
+Needs to include OPNFV default ports and addresses and
+references to upstream documentation applicable for an
+OPNFV deployment.
diff --git a/docs/userguide/ovs.rst b/docs/userguide/ovs.rst
new file mode 100644
index 000000000..9209ac61c
--- /dev/null
+++ b/docs/userguide/ovs.rst
@@ -0,0 +1,7 @@
+OVS User Guide
+==============
+
+Add OVS specific user guide information here.
+Needs to include OPNFV default ports and addresses and
+references to upstream documentation applicable for an
+OPNFV deployment.
diff --git a/docs/userguide/userguide.rst b/docs/userguide/userguide.rst
deleted file mode 100644
index b129b5d2e..000000000
--- a/docs/userguide/userguide.rst
+++ /dev/null
@@ -1,30 +0,0 @@
-
-
-OPNFV User Guide
-================
-
-abstact.rst
-
-????????????????
-================
-
-Table of content
-
-introduction.rst
-
-configuration-overview.rst
-
-General system usage
-====================
-Openstack.rst
-Opendaylight.rst
-onos.rst
-xxx.rst
-xxx.rst
-
-Using Brahmaputra features
-==========================
-projectxyz.rst
-
-
-