X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_functional_tests%2Foverview.rst;fp=docs%2Freport%2Fvpp_functional_tests_virl%2Foverview.rst;h=e85bb92f7be122a685ac53fd914a1fe4dce513ef;hp=16c7ef7ba0c15760214feb2b02498d4987a2f3fd;hb=da2aa127ee071e37bc4d6060dd39476179e65365;hpb=a1d482fcf9c221cda2f13429810bca945d9f09f4

diff --git a/docs/report/vpp_functional_tests_virl/overview.rst b/docs/report/vpp_functional_tests/overview.rst
similarity index 78%
rename from docs/report/vpp_functional_tests_virl/overview.rst
rename to docs/report/vpp_functional_tests/overview.rst
index 16c7ef7ba0..e85bb92f7b 100644
--- a/docs/report/vpp_functional_tests_virl/overview.rst
+++ b/docs/report/vpp_functional_tests/overview.rst
@@ -1,8 +1,8 @@
 Overview
 ========
 
-Tested Topologies VIRL
-----------------------
+Tested Virtual Topologies
+-------------------------
 
 CSIT VPP functional tests are executed on virtualized topologies created using
 Virtual Internet Routing Lab (VIRL) simulation platform contributed by Cisco.
@@ -94,10 +94,10 @@ is shown in the figure below including the applicable packet flow thru the VM
          ******************* |           |********************
                              +-----------+
 
-VPP Functional Tests Overview
------------------------------
+Functional Tests Coverage
+-------------------------
 
-Following VPP functional test areas are included in the CSIT |release| with
+Following VPP functional test areas are covered in the CSIT |release| with
 results listed in this report:
 
 - **DHCP - Client and Proxy** - Dynamic Host Control Protocol Client and Proxy
@@ -127,3 +127,35 @@ results listed in this report:
   IPv6.
 - **VLAN Tag Translation** - L2 VLAN tag translation 2to2, 2to1, 1to2, 1to1.
 - **VXLAN Overlay Tunnels** - VXLAN tunneling for L2-over-IP, for IPv4, IPv6.
+
+Functional Tests Naming
+-----------------------
+
+CSIT |release| introduced a common structured naming convention for all
+performance and functional tests. This change was driven by substantially
+growing number and type of CSIT test cases. Firstly, the original practice did
+not always follow any strict naming convention. Secondly test names did not
+always clearly capture tested packet encapsulations, and the actual type or
+content of the tests. Thirdly HW configurations in terms of NICs, ports and
+their locality were not captured either. These were but few reasons that drove
+the decision to change and define a new more complete and stricter test naming
+convention, and to apply this to all existing and new test cases.
+
+The new naming should be intuitive for majority of the tests. The complete
+description of CSIT test naming convention is provided on `CSIT test naming
+page <https://wiki.fd.io/view/CSIT/csit-test-naming>`_.
+
+Here few illustrative examples of the new naming usage for functional test
+suites:
+
+#. **Physical port to physical port - a.k.a. NIC-to-NIC, Phy-to-Phy, P2P**
+
+    - *eth2p-ethip4-ip4base-func.robot* => 2 ports of Ethernet, IPv4 baseline
+      routed forwarding, functional tests.
+
+#. **Physical port to VM (or VM chain) to physical port - a.k.a. NIC2VM2NIC,
+   P2V2P, NIC2VMchain2NIC, P2V2V2P**
+
+    - *eth2p-ethip4vxlan-l2bdbasemaclrn-eth-2vhost-1vm-func.robot* => 2 ports of
+      Ethernet, IPv4 VXLAN Ethernet, L2 bridge-domain switching to/from two vhost
+      interfaces and one VM, functional tests.