CSIT doc: Add chapter numbering

Change-Id: I5cdcda0461e6f4bdabd91ea440edf7a71db9afd9
Signed-off-by: Tibor Frank <tifrank@cisco.com>

5 files changed, 72 insertions, 76 deletions

diff --git a/resources/tools/doc_gen/src/conf.py b/resources/tools/doc_gen/src/conf.py
index e41868582e..9d39da08f2 100644
--- a/resources/tools/doc_gen/src/conf.py
+++ b/resources/tools/doc_gen/src/conf.py
@@ -54,7 +54,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'CSIT'
-copyright = u'2016, CSIT'
+copyright = u'2017, FD.io'
 author = u'CSIT'
 
 # The version info for the project you're documenting, acts as replacement for
@@ -62,9 +62,9 @@ author = u'CSIT'
 # built documents.
 #
 # The short X.Y version.
-version = u'master'
+# version = u'master'
 # The full version, including alpha/beta/rc tags.
-release = u'master'
+# release = u'master'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/resources/tools/doc_gen/src/index.rst b/resources/tools/doc_gen/src/index.rst
index b92ecd6bd4..77c6966150 100644
--- a/resources/tools/doc_gen/src/index.rst
+++ b/resources/tools/doc_gen/src/index.rst
@@ -1,78 +1,14 @@
-.. |csit| replace:: Continuous System Integration and Testing
-
-
-|csit| Description
-==================
-
-#. Development of software code for fully automated VPP code testing, functionality, performance, regression and new functions.
-#. Execution of CSIT test suites on VPP code running on LF FD.io virtual and physical compute environments.
-#. Integration with FD.io continuous integration systems (Gerrit, Jenkins and such).
-#. Identified existing FD.io project dependencies and interactions:
-    - vpp - Vector Packet Processing.
-    - honeycomb - Honeycomb Agent for management plane testing.
-    - ci-management - Management repo for Jenkins Job Builder, script and management related to the Jenkins CI configuration.
-
-Project Scope
--------------
-
-#. Automated regression testing of VPP code changes
-    - Functionality of VPP data plane, network control plane, management plane against functional specifications.
-    - Performance of VPP data plane including non-drop-rate packet throughput and delay, against established reference benchmarks.
-    - Performance of network control plane against established reference benchmarks.
-    - Performance of management plane against established reference benchmarks.
-#. Test case definitions driven by supported and planned VPP functionality, interfaces and performance:
-    - Uni-dimensional tests: Data plane, (Network) Control plane, Management plane.
-    - Multi-dimensional tests: Use case driven.
-#. Integration with FD.io Continuous Integration system including FD.io Gerrit and Jenkins
-    - Automated test execution triggered by VPP-VERIFY jobs other VPP and CSIT project jobs.
-#. Integration with LF VPP test execution environment
-    - Functional tests execution on LF hosted VM environment.
-    - Performance and functional tests execution on LF hosted physical compute environment.
-    - Subset of tests executed on LF hosted physical compute running VIRL (Virtual Internet Routing Lab).
-
-|csit| Documentation
---------------------
-
-Python Library
-##############
+Contents
+--------
 
 .. toctree::
-   :maxdepth: 2
+   :numbered:
+   :maxdepth: 1
    :glob:
-   
-   resources.libraries.python
-
-Robot Library
-#############
 
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   
+   overview
+   resources.libraries.python
    resources.libraries.robot
-
-Functional Tests
-################
-
-.. toctree::
-   :maxdepth: 3
-   :glob:
-   
    tests.func
-
-Performance Tests
-#################
-
-.. toctree::
-   :maxdepth: 2
-   :glob:
-   
    tests.perf
-   
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+   indices
diff --git a/resources/tools/doc_gen/src/indices.rst b/resources/tools/doc_gen/src/indices.rst
new file mode 100644
index 0000000000..d46b839f66
--- /dev/null
+++ b/resources/tools/doc_gen/src/indices.rst
@@ -0,0 +1,6 @@
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/resources/tools/doc_gen/src/overview.rst b/resources/tools/doc_gen/src/overview.rst
new file mode 100644
index 0000000000..f9cc4e4ed4
--- /dev/null
+++ b/resources/tools/doc_gen/src/overview.rst
@@ -0,0 +1,54 @@
+.. |csit| replace:: Continuous System Integration and Testing
+
+CSIT Description
+================
+
+#. Development of software code for fully automated VPP code testing,
+   functionality, performance, regression and new functions.
+
+#. Execution of CSIT test suites on VPP code running on LF FD.io virtual and
+   physical compute environments.
+
+#. Integration with FD.io continuous integration systems (Gerrit, Jenkins and
+   such).
+
+#. Identified existing FD.io project dependencies and interactions:
+
+    - vpp - Vector Packet Processing.
+    - honeycomb - Honeycomb Agent for management plane testing.
+    - ci-management - Management repo for Jenkins Job Builder, script and
+      management related to the Jenkins CI configuration.
+
+Project Scope
+-------------
+
+#. Automated regression testing of VPP code changes
+
+    - Functionality of VPP data plane, network control plane, management plane
+      against functional specifications.
+    - Performance of VPP data plane including non-drop-rate packet throughput
+      and delay, against established reference benchmarks.
+    - Performance of network control plane against established reference
+      benchmarks.
+    - Performance of management plane against established reference benchmarks.
+
+#. Test case definitions driven by supported and planned VPP functionality,
+   interfaces and performance:
+
+    - Uni-dimensional tests: Data plane, (Network) Control plane, Management
+      plane.
+    - Multi-dimensional tests: Use case driven.
+
+#. Integration with FD.io Continuous Integration system including FD.io Gerrit
+   and Jenkins
+
+    - Automated test execution triggered by VPP-VERIFY jobs other VPP and CSIT
+      project jobs.
+
+#. Integration with LF VPP test execution environment
+
+    - Functional tests execution on LF hosted VM environment.
+    - Performance and functional tests execution on LF hosted physical compute
+      environment.
+    - Subset of tests executed on LF hosted physical compute running VIRL
+      (Virtual Internet Routing Lab).
diff --git a/resources/tools/doc_gen/src/requirements.txt b/resources/tools/doc_gen/src/requirements.txt
index 8f3e9a5503..cf6b0e6df6 100644
--- a/resources/tools/doc_gen/src/requirements.txt
+++ b/resources/tools/doc_gen/src/requirements.txt
@@ -1,3 +1,3 @@
-Sphinx==1.4.8
-sphinxcontrib_robotdoc==0.8.0
+Sphinx
+sphinxcontrib_robotdoc
 sphinx-rtd-theme
\ No newline at end of file