From 5362fa4f79de701a737b4d1ff794ad4e513f6486 Mon Sep 17 00:00:00 2001 From: Tibor Frank Date: Fri, 27 Jan 2017 14:50:31 +0100 Subject: [PATCH] CSIT doc: Add chapter numbering Change-Id: I5cdcda0461e6f4bdabd91ea440edf7a71db9afd9 Signed-off-by: Tibor Frank --- resources/tools/doc_gen/src/conf.py | 6 +-- resources/tools/doc_gen/src/index.rst | 78 +++------------------------- resources/tools/doc_gen/src/indices.rst | 6 +++ resources/tools/doc_gen/src/overview.rst | 54 +++++++++++++++++++ resources/tools/doc_gen/src/requirements.txt | 4 +- 5 files changed, 72 insertions(+), 76 deletions(-) create mode 100644 resources/tools/doc_gen/src/indices.rst create mode 100644 resources/tools/doc_gen/src/overview.rst 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 -- 2.16.6