docs: reorganize docs for the sphinx build

Reorganize docs into the appropriate folders for the new sphinx build.
JIRA: VSPERF-80

Change-Id: I9dcd74e092ce52546a0986b92a1ebb2b5b7419bf
Signed-off-by: Ramprasad Velavarthipati <ram.v@freescale.com>
Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com>
Reviewed-by: Trinath Somanchi <trinath.somanchi@gmail.com>

14 files changed, 129 insertions, 19 deletions

diff --git a/docs/design/index.rst b/docs/design/index.rst
new file mode 100755
index 00000000..f5d2cc5d
--- /dev/null
+++ b/docs/design/index.rst
@@ -0,0 +1,27 @@
+.. OPNFV Release Engineering documentation, created by
+   sphinx-quickstart on Tue Jun  9 19:12:31 2015.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+
+VSPERF Design
+=======================================
+
+Contents:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   vswitchperf_design.rst
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|
diff --git a/docs/to-be-reorganized/vswitchperf_design.rst b/docs/design/vswitchperf_design.rst
index 689c2098..d7fa67c3 100644..100755
--- a/docs/to-be-reorganized/vswitchperf_design.rst
+++ b/docs/design/vswitchperf_design.rst
@@ -38,7 +38,7 @@ Typical Test Sequence
 
 This is a typical flow of control for a test.
 
-.. image:: images/vsperf.png
+.. image:: ../images/vsperf.png
 
 
 Configuration
@@ -156,7 +156,7 @@ Similarly the Traffic Controllers can be used to co-ordinate basic operations pr
 Traffic Controller's Role
 -------------------------
 
-.. image:: images/traffic_controller.png
+.. image:: ../images/traffic_controller.png
 
 
 Loader & Component Factory
@@ -164,7 +164,7 @@ Loader & Component Factory
 
 The working of the Loader package (which is responsible for *finding* arbitrary classes based on configuration data) and the Component Factory which is responsible for *choosing* the correct class for a particular situation - e.g. Deployment Scenario can be seen in this diagram.
 
-.. image:: images/factory_and_loader.png
+.. image:: ../images/factory_and_loader.png
 
 Routing Tables
 ==============
diff --git a/docs/guides/index.rst b/docs/guides/index.rst
new file mode 100755
index 00000000..c2b197d2
--- /dev/null
+++ b/docs/guides/index.rst
@@ -0,0 +1,28 @@
+.. OPNFV Release Engineering documentation, created by
+   sphinx-quickstart on Tue Jun  9 19:12:31 2015.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+
+VSPERF Guides and Installation
+========================================
+
+Contents:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   quickstart.rst
+   installation.rst
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|
diff --git a/docs/to-be-reorganized/installation.rst b/docs/guides/installation.rst
index 272993ef..272993ef 100644..100755
--- a/docs/to-be-reorganized/installation.rst
+++ b/docs/guides/installation.rst
diff --git a/docs/to-be-reorganized/quickstart.rst b/docs/guides/quickstart.rst
index 2a071d4f..630da7da 100644..100755
--- a/docs/to-be-reorganized/quickstart.rst
+++ b/docs/guides/quickstart.rst
@@ -333,4 +333,4 @@ an appropriate amount of memory:
 
 --------------
 
-.. |Alt text| image:: images/TCLServerProperties.png
+.. |Alt text| image:: ../images/TCLServerProperties.png
diff --git a/docs/to-be-reorganized/images/TCLServerProperties.png b/docs/images/TCLServerProperties.png
index 682de7c5..682de7c5 100644
--- a/docs/to-be-reorganized/images/TCLServerProperties.png
+++ b/docs/images/TCLServerProperties.png
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100755
index 00000000..bb0a6988
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,30 @@
+.. OPNFV Release Engineering documentation, created by
+   sphinx-quickstart on Tue Jun  9 19:12:31 2015.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. image:: etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+
+VSPERF
+=======================================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 4
+   :titlesonly:
+
+   guides/index
+   design/index
+   test_spec/index
+   updates/index
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|
diff --git a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-00.xml b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-00.xml
index b5f7f833..b5f7f833 100755
--- a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-00.xml
+++ b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-00.xml
diff --git a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.txt b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.txt
index 81ae96c0..81ae96c0 100755
--- a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.txt
+++ b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.txt
diff --git a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.xml b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.xml
index b5f7f833..b5f7f833 100755
--- a/docs/to-be-reorganized/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.xml
+++ b/docs/test_spec/ietf_draft/draft-vsperf-bmwg-vswitch-opnfv-01.xml
diff --git a/docs/to-be-reorganized/index.rst b/docs/test_spec/index.rst
index 1594d741..1ae1669a 100644..100755
--- a/docs/to-be-reorganized/index.rst
+++ b/docs/test_spec/index.rst
@@ -9,7 +9,7 @@
   :alt: OPNFV
   :align: left
 
-Example Documentation table of contents
+VSPERF Test Specification
 =======================================
 
 Contents:
@@ -19,12 +19,10 @@ Contents:
    :maxdepth: 4
 
    quickstart.rst
+   installation.rst
    NEWS.rst
    vswitchperf_ltd.rst
-   installation.rst
-
-Indices and tables
-==================
+   vswitchperf_design.rst
 
 * :ref:`search`
 
diff --git a/docs/to-be-reorganized/vswitchperf_ltd.rst b/docs/test_spec/vswitchperf_ltd.rst
index 15c1de5c..5a7a7f2b 100755
--- a/docs/to-be-reorganized/vswitchperf_ltd.rst
+++ b/docs/test_spec/vswitchperf_ltd.rst
@@ -96,22 +96,22 @@ includes measuring the following performance metrics:
   meaning to different groups of people. In this document we will
   simply use the term packet delay variation. The preferred form for this
   metric is the PDV form of delay variation defined in `RFC5481
-  <https://www.rfc-editor.org/rfc/rfc5481.txt>`__. The most relevant 
+  <https://www.rfc-editor.org/rfc/rfc5481.txt>`__. The most relevant
   measurement of PDV considers the delay variation of a single user flow,
   as this will be relevant to the size of end-system buffers to compensate
-  for delay variation. The measurement system's ability to store the 
-  delays of individual packets in the flow of interest is a key factor 
-  that determines the specific measurement method. At the outset, it is 
+  for delay variation. The measurement system's ability to store the
+  delays of individual packets in the flow of interest is a key factor
+  that determines the specific measurement method. At the outset, it is
   ideal to view the complete PDV distribution. Systems that can capture
-  and store packets and their delays have the freedom to calculate the 
+  and store packets and their delays have the freedom to calculate the
   reference minimum delay and to determine various quantiles of the PDV
-  distribution accurately (in post-measurement processing routines). 
+  distribution accurately (in post-measurement processing routines).
   Systems without storage must apply algorithms to calculate delay and
-  statistical measurements on the fly. For example, a system may store 
-  temporary estimates of the mimimum delay and the set of (100) packets 
+  statistical measurements on the fly. For example, a system may store
+  temporary estimates of the mimimum delay and the set of (100) packets
   with the longest delays during measurement (to calculate a high quantile,
-  and update these sets with new values periodically. 
-  In some cases, a limited number of delay histogram bins will be 
+  and update these sets with new values periodically.
+  In some cases, a limited number of delay histogram bins will be
   available, and the bin limits will need to be set using results from
   repeated experiments. See section 8 of `RFC5481
   <https://www.rfc-editor.org/rfc/rfc5481.txt>`__.
diff --git a/docs/to-be-reorganized/NEWS.rst b/docs/updates/NEWS.rst
index 0fe9e22b..0fe9e22b 100644..100755
--- a/docs/to-be-reorganized/NEWS.rst
+++ b/docs/updates/NEWS.rst
diff --git a/docs/updates/index.rst b/docs/updates/index.rst
new file mode 100755
index 00000000..9d1e47e0
--- /dev/null
+++ b/docs/updates/index.rst
@@ -0,0 +1,27 @@
+.. OPNFV Release Engineering documentation, created by
+   sphinx-quickstart on Tue Jun  9 19:12:31 2015.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+
+VSPERF News
+=======================================
+
+Contents:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   NEWS.rst
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|