X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Foverview.rst;h=dc86f8600ed5bc67fad89d763e94fd2b1cfe5c8b;hp=e3b343c815876b9e8455c2c6aa4641f89f93576f;hb=35e5a327a66c05a3356d214dcfdece59ca725998;hpb=6baa0bc9921bc13b1adff113c20a4db766c3feba

diff --git a/docs/report/introduction/overview.rst b/docs/report/introduction/overview.rst
index e3b343c815..dc86f8600e 100644
--- a/docs/report/introduction/overview.rst
+++ b/docs/report/introduction/overview.rst
@@ -1,16 +1,42 @@
 Overview
 ========
 
-This is the Fast Data Project (FD.io) Continuous System Integration and Testing
-(CSIT) project report for CSIT |release| system testing of VPP-17.01 release.
-Initial sections of the report describe FD.io functional and performance tests
-and their continuous execution achieved in CSIT |release|. This is followed by
-high-level overview of FD.io test environments running in Linux Foundation
-(LF) FD.io Continuous Performance Labs), CSIT |release| release notes and
-result highlights. Subsequent sections list the functional and performance
-detailed test results generated by LF FD.io Jenkins system executing CSIT jobs
-running tests  against the VPP-17.01 release and associated sub-systems
-(HoneyComb, DPDK).
+This is the **F**\ast **D**\ata **I**/**O** Project (FD.io) **C**\ontinuous
+**S**\ystem **I**\ntegration and **T**\esting (CSIT) project report for CSIT
+|release| system testing of VPP-17.01 release. Initial sections of the report
+describe FD.io functional and performance tests and their continuous execution
+achieved in CSIT |release|. This is followed by high-level overview of FD.io
+test environments running in Linux Foundation (LF) FD.io Continuous
+Performance Labs), CSIT |release| release notes and result highlights.
+Subsequent sections list the functional and performance detailed test results
+generated by LF FD.io Jenkins system executing CSIT jobs running tests
+against the VPP-17.01 release and associated sub-systems (HoneyComb, DPDK).
+
+The exact structure of the report is as follows:
+
+#. ``Introduction`` - Includes: ``Overview`` - this section;
+   ``CSIT Test Naming`` - describing CSIT naming convention for test suites and
+   test cases, important to understand to correctly interpret the reported
+   results; ``General Remarks`` - additional notes related to this report.
+#. ``VPP Performance Tests HW`` - Summary of VPP performance tests executed in
+   physical Hardware testbed. Includes: ``Overview`` - containing topology
+   description and list of executed tests; ``Performance Tests Naming`` - lists
+   CSIT naming specifics for performance tests; ``CSIT Release Notes`` - with
+   changes in CSIT |release| including major test additions, performance
+   improvements, changes in testing environment and methodology and known
+   issues; ``Performance Measurements Methodology`` - details testing
+   methodology followed for multi-thread multi-core, packet throughput and
+   latency, and KVM VM vhost tests; ``Report Addendum Targets`` - lists content
+   to be added to this report as part of CSIT |release|.
+#. ``Testpmd Performance Tests HW`` - ...
+#. ``VPP Functional Tests VIRL`` - ...
+#. ``VPP Functional Tests VPPtest`` - ...
+#. ``HoneyComb Functional Tests VIRL`` - ..
+#. ``VPP Performance Results HW`` - ...
+#. ``Testpmd Performance Results HW`` - ...
+#. ``VPP Functional Results VIRL`` - ...
+#. ``VPP Functional Results VPPtest`` - ...
+#. ``HoneyComb Functional Results VIRL`` - ...
 
 FD.io CSIT system is developed using two main coding platforms: Robot
 Framework (RF) and Python. CSIT |release| source code for the executed test