summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorChristopherPrice <christopher.price@ericsson.com>2016-01-17 17:31:32 +0100
committerChristopherPrice <christopher.price@ericsson.com>2016-01-19 08:54:50 +0100
commitce8095ad253cce2a5ac7935a3ce604fc71bb526d (patch)
tree8b13a14dfea60a5a93057708fd89f9eeaad2c159 /docs
parentb06e6192305980b7142e0a410817f2a58df3727a (diff)
Updating the index.rst file to include referred content.
Adding new committers in the INFO file. This patch includes updates to the index files to establish the correct structure for the composite docs in Brahmaputra. The patch also includes an updated INFO file adding Ryota Mibu and Sofia Wallin as committers to the project. add the include references. Change-Id: Ife98bd25ac3c80d2737132867449ee11f45a581e Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/configguide/feature-config.rst7
-rw-r--r--docs/configguide/index.rst23
-rw-r--r--docs/configguide/installer-config.rst8
-rw-r--r--docs/configguide/post-install.rst7
-rw-r--r--docs/userguide/feature-usage.rst7
-rw-r--r--docs/userguide/general-system.rst11
-rw-r--r--docs/userguide/index.rst33
7 files changed, 49 insertions, 47 deletions
diff --git a/docs/configguide/feature-config.rst b/docs/configguide/feature-config.rst
new file mode 100644
index 000000000..df9728bb9
--- /dev/null
+++ b/docs/configguide/feature-config.rst
@@ -0,0 +1,7 @@
+Feature Configuration
+=====================
+
+The following sections describe the configuration options for specific platform features provided in Brahmaputra.
+Further details for each feature are captured in the referred project documentation.
+
+.. include:: ../projects/sdnvpn/configguide/configguide.rst
diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst
index 39e3be34d..0a47f1589 100644
--- a/docs/configguide/index.rst
+++ b/docs/configguide/index.rst
@@ -9,26 +9,9 @@ Contents:
./abstract
./introduction
./configoptions
-
-Installer Configuration
-=======================
-
-Waiting for the structue in the installer repo's to
-add the include references.
-
-Feature Configuration
-=====================
-
-.. toctree::
- :maxdepth: 2
-
-.. include:: ../projects/sdnvpn/configguide/configguide.rst
-
-Post Configuration Activities
-=============================
-
-Waiting for the structue in the remote repo's to
-add the include references.
+ ./installer-config
+ ./feature-config
+ ./post-install
Indices and tables
==================
diff --git a/docs/configguide/installer-config.rst b/docs/configguide/installer-config.rst
new file mode 100644
index 000000000..89632ea3f
--- /dev/null
+++ b/docs/configguide/installer-config.rst
@@ -0,0 +1,8 @@
+Installer Configuration
+=======================
+
+The following sections describe the per installer configuration options.
+Further details for each installer are captured in the referred project documentation.
+
+.. include:: ../projects/fuel/configguide/installerconfig.rst
+.. include:: ../projects/joid/configguide/installerconfig.rst
diff --git a/docs/configguide/post-install.rst b/docs/configguide/post-install.rst
new file mode 100644
index 000000000..b63d44aac
--- /dev/null
+++ b/docs/configguide/post-install.rst
@@ -0,0 +1,7 @@
+Post Configuration Activities
+=============================
+
+This section describes the post configuration activitites that will allow you to validate the success
+of your configuration. Further details may be found in the referred project specific documentation.
+
+.. include:: ../projects/joid/configguide/postinstall.rst
diff --git a/docs/userguide/feature-usage.rst b/docs/userguide/feature-usage.rst
new file mode 100644
index 000000000..ea1e9e54e
--- /dev/null
+++ b/docs/userguide/feature-usage.rst
@@ -0,0 +1,7 @@
+Using Brahmaputra Features
+==========================
+
+This section of the user guide provides feature specific user guides and references.
+This provides user information when leveraging the features in the platform where as a user you may
+need to perform operations, many operation in this section refer to the guides in the general system usage
+section.
diff --git a/docs/userguide/general-system.rst b/docs/userguide/general-system.rst
new file mode 100644
index 000000000..3865f3dd7
--- /dev/null
+++ b/docs/userguide/general-system.rst
@@ -0,0 +1,11 @@
+General system usage
+====================
+
+This section of the user guide provides general system component user guides and references.
+This provides user information for common components of the platform where as a user you may
+need to perform operations, depending on the scenario deployed and types of activities you are doing.
+
+.. include:: ./openstack.rst
+.. include:: ./opendaylight.rst
+.. include:: ./onos.rst
+.. include:: ./ovs.rst
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index 6aea80894..023c1d317 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -1,36 +1,15 @@
-.. OPNFV User Guide documentation master file, created by
- sphinx-quickstart on Tue Nov 24 10:30:29 2015.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
-Welcome to OPNFV User Guide
-===========================
-
-.. toctree::
- :maxdepth: 2
-
- abstract.rst
- introduction.rst
-
-General system usage
-====================
+OPNFV User Guide
+================
.. toctree::
:maxdepth: 2
- openstack.rst
- opendaylight.rst
- onos.rst
- ovs.rst
-
-Using Brahmaputra Features
-==========================
-
-.. include:: ./projects-userguide.rst
+ ./abstract
+ ./introduction
+ ./general-system
+ ./feature-usage
Indices and tables
==================
-* :ref:`genindex`
-* :ref:`modindex`
* :ref:`search`