1 files changed, 146 insertions, 0 deletions
diff --git a/docs/report/introduction/introduction.rst b/docs/report/introduction/introduction.rst
new file mode 100644
index 0000000000..c88aeb4e30
--- /dev/null
+++ b/docs/report/introduction/introduction.rst
@@ -0,0 +1,146 @@
+Introduction
+============
+
+This is FD.io CSIT (Fast Data i/o Continuous System Integration and
+Testing) project report for |csit-release| system performance and
+functional testing of |vpp-release|.
+
+There is also a downloadable `PDF version of this report`_.
+
+This report describes CSIT performance and functional tests delivered in
+|csit-release|. A high-level overview is provided for each CSIT test
+environment running in :abbr:`LF (Linux Foundation)` FD.io Continuous
+Performance Labs. This is followed by summary of all executed tests
+against the |vpp-release| and associated FD.io projects and sub-systems
+(Honeycomb, DPDK, NSH_SFC, DMM), |csit-release| release notes, result
+highlights and known issues discovered in CSIT. More detailed
+description of each environment, pointers to CSIT test code
+documentation and detailed test resuls with links to the source data
+files are also provided.
+
+|csit-release| report contains following main sections and sub-sections:
+
+#. **Introduction**: general introduction to CSIT project.
+
+   - **Introduction**: this section.
+   - **Test Scenarios Overview**: a brief overview of test scenarios
+     covered in this report.
+   - **Physical Testbeds**: description of physical testbeds.
+   - **Performance Test Methodology**: benchmarking methodologies.
+
+#. **VPP Performance**: VPP performance tests executed in physical
+   FD.io testbeds.
+
+   - **Overview**: tested logical topologies, test coverage and naming
+     specifics.
+   - **Release Notes**: changes in |csit-release|, added tests,
+     performance changes, environment or methodology changes, known
+     issues.
+   - **Packet Throughput**: NDR, PDR throughput graphs based on results
+     from repeated same test job executions to verify repeatibility of
+     measurements.
+   - **Packet Latency**: Latency graphs based on results from test job
+     executions.
+   - **Speedup Multi-Core**: NDR, PDR throughput multi-core speedup
+     graphs based on results from test job executions.
+   - **HTTP/TCP Performance**: HTTP/TCP VPP test server performance
+     graphs.
+   - **Test Environment**: performance test environment configuration.
+   - **Documentation**: documentation of K8s Pod/Container orchestration
+     in CSIT and pointers to CSIT source code documentation for VPP
+     performance tests.
+
+#. **DPDK Performance**: DPDK performance tests executed in physical
+   FD.io testbeds.
+
+   - **Overview**: tested logical topologies, test coverage.
+   - **Release Notes**: changes in |csit-release|, known issues.
+   - **Packet Throughput**: NDR, PDR throughput graphs based on results
+     from repeated same test job executions to verify repeatibility of
+     measurements.
+   - **Packet Latency**: Latency graphs based on results from test job
+     executions.
+   - **Test Environment**: performance test environment configuration.
+   - **Documentation**: pointers to CSIT source code documentation for
+     DPDK performance tests.
+
+#. **VPP Functional**: VPP functional tests executed in virtual FD.io
+   testbeds.
+
+   - **Overview**: tested virtual topologies, test coverage and naming
+     specifics;
+   - **Release Notes** - changes in |csit-release|, added tests,
+     environment or methodology changes, known issues.
+   - **Test Environment**: functional test environment configuration.
+   - **Documentation**: pointers to CSIT source code documentation for
+     VPP functional tests.
+
+#. **Honeycomb Functional**: Honeycomb functional tests executed in
+   virtual FD.io testbeds.
+
+   - **Overview**: tested virtual topologies, test coverage and naming
+     specifics;
+   - **Release Notes** - changes in |csit-release|, known issues.
+   - **Test Environment**: functional test environment configuration.
+   - **Documentation**: pointers to CSIT source code documentation for
+     Honeycomb functional tests.
+
+#. **NSH_SFC Functional**: NSH_SFC functional tests executed in
+   virtual FD.io testbeds.
+
+   - **Overview**: tested virtual topologies, test coverage and naming
+     specifics;
+   - **Release Notes** - changes in |csit-release|, known issues.
+   - **Test Environment**: functional test environment configuration.
+   - **Documentation**: pointers to CSIT source code documentation for
+     NSH_SFC functional tests.
+
+#. **DMM Functional**: DMM functional tests executed in
+   virtual FD.io testbeds.
+
+   - **Overview**: tested virtual topologies, test coverage and naming
+     specifics;
+   - **Release Notes** - changes in |csit-release|, known issues.
+   - **Test Environment**: functional test environment configuration.
+   - **Documentation**: pointers to CSIT source code documentation for
+     DMM functional tests.
+
+#. **Detailed Results**: detailed result tables auto-generated from CSIT
+   test job executions using RF (Robot Framework) output files as
+   sources.
+
+   - **VPP Performance NDR/PDR**: VPP NDR/PDR throughput and latency.
+   - **VPP Performance MRR**: VPP MRR throughput.
+   - **VPP K8s Container Memif**: VPP K8s Container/Pod topologies
+     NDR/PDR throughput.
+   - **DPDK Performance**: DPDK Testpmd and L3fwd NDR/PDR throughput
+     and latency.
+   - **VPP Functional**: detailed VPP functional results.
+   - **Honeycomb Functional**: detailed HoneyComb functional results.
+   - **NSH_SFC Functional**: detailed nsh-plugin functional results.
+   - **DMM Functional**: detailed DMM functional results.
+
+#. **Test Configuration**: VPP DUT configuration data based on VPP API
+   Test (VAT) Commands History auto-generated from CSIT test job
+   executions using RF output files as sources.
+
+   - **VPP Performance NDR/PDR**: configuration data.
+   - **VPP Performance MRR**: configuration data.
+   - **VPP K8s Container Memif**: configuration data.
+   - **VPP Functional**: configuration data.
+
+#. **Test Operational Data**: VPP DUT operational data auto-generated
+   from CSIT test job executions using RFoutput files as sources.
+
+   - **VPP Performance NDR/PDR**: VPP `show run` outputs under test
+     load.
+
+#. **CSIT Framework Documentation**: description of the overall FD.io
+   CSIT framework.
+
+   - **Design**: framework modular design hierarchy.
+   - **Test naming**: test naming convention.
+   - **Presentation and Analytics Layer**: description of PAL CSIT
+     analytics module.
+   - **CSIT RF Tags Descriptions**: CSIT RF Tags used for test suite and
+     test case grouping and selection.