X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Ftag_documentation.rst;h=3da5478af5c8945d546d821ba5331af83c63425f;hp=3e2d44df73eec2ae118125cca7160e2fc157b950;hb=785519e26196b9e0a5016d0fc54ed099fd0a920f;hpb=d166ae0881c29dfd05ed61b9a12156f17981bb6d

diff --git a/docs/tag_documentation.rst b/docs/tag_documentation.rst
index 3e2d44df73..3da5478af5 100644
--- a/docs/tag_documentation.rst
+++ b/docs/tag_documentation.rst
@@ -1,8 +1,10 @@
 CSIT TAGs Descriptions
 ======================
 
-Documentation for tags used to select and identify test cases.
-
+All CSIT test cases are labelled with Robot Framework tags used to allow for
+easy test case type identification, test case grouping and selection for
+execution. Following sections list currently used CSIT TAGs and their
+documentation.
 
 Topology TAGs
 -------------
@@ -17,7 +19,6 @@ Topology TAGs
     3 nodes connected in a circular topology with at least one link
     interconnecting devices.
 
-
 Objective TAGs
 --------------
 
@@ -30,7 +31,6 @@ Objective TAGs
 
     Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch).
 
-
 Environment TAGs
 ----------------
 
@@ -46,7 +46,6 @@ Environment TAGs
 
     DUTs with VPP and capable of running Virtual Machine.
 
-
 NIC model tags
 --------------
 
@@ -70,7 +69,6 @@ NIC model tags
 
     VIC-1385 by Cisco.
 
-
 Scaling TAGs
 ------------
 
@@ -110,7 +108,6 @@ Scaling TAGs
 
     Traffic flow with 4000 unique IPs (users) in one direction.
 
-
 Tags marking functional vs. performance of tests
 ------------------------------------------------
 
@@ -122,7 +119,6 @@ Tags marking functional vs. performance of tests
 
     All performance test cases.
 
-
 Performance testing tags
 ------------------------
 
@@ -221,9 +217,8 @@ Test type tags
     At least one feature is configured in test cases. Use also feature tag(s).
 
 .. topic:: TLDK
-    
-    Functional test cases for TLDK.
 
+    Functional test cases for TLDK.
 
 Forwarding mode tags
 --------------------
@@ -248,7 +243,6 @@ Forwarding mode tags
 
     VPP IPv6 routed forwarding.
 
-
 Underlay tags
 -------------
 
@@ -264,7 +258,6 @@ Underlay tags
 
     MPLS underlay.
 
-
 Overlay tags
 ------------
 
@@ -280,7 +273,6 @@ Overlay tags
 
     IPv6 overlay (IPv6 payload).
 
-
 Encapsulation tags
 ------------------
 
@@ -320,7 +312,6 @@ Encapsulation tags
 
     All test cases with IPSEC.
 
-
 Interface tags
 --------------
 
@@ -363,7 +354,6 @@ Feature tags
 
     SNAT configured and tested.
 
-
 Encryption tags
 ---------------
 
@@ -383,7 +373,6 @@ Encryption tags
 
     IPSec in tunnel mode.
 
-
 Client-workload tags
 --------------------
 
@@ -399,7 +388,6 @@ Client-workload tags
 
     All test cases with specific APP use.
 
-
 Multi-threading tags
 --------------------
 
@@ -452,7 +440,6 @@ Multi-threading tags
     8 worker threads pinned to 8 dedicated physical cores. 4 receive queues per
     interface. Main thread pinned to core 0.
 
-
 Honeycomb tags
 --------------