X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_performance_tests%2Fthroughput_speedup_multi_core%2Findex.rst;h=b3504010f31033e5788fa5cc2febec2320eb7ec9;hp=b3f95ec6c3ca8f9853517b6ca1452ca2dbb5cae0;hb=e0e76e6ac30312d84424023a76d612606e0040d4;hpb=2fc7ba3b3b5dad5a211310d529c5a375dea8b946

diff --git a/docs/report/vpp_performance_tests/throughput_speedup_multi_core/index.rst b/docs/report/vpp_performance_tests/throughput_speedup_multi_core/index.rst
index b3f95ec6c3..b3504010f3 100644
--- a/docs/report/vpp_performance_tests/throughput_speedup_multi_core/index.rst
+++ b/docs/report/vpp_performance_tests/throughput_speedup_multi_core/index.rst
@@ -1,31 +1,51 @@
-.. _throughput_speedup_multi_core:
 
 .. raw:: latex
 
     \clearpage
 
+.. _throughput_speedup_multi_core:
+
 Speedup Multi-Core
 ==================
 
-Throughput Speedup Multi-Core graphs are generated based on results from
-multiple executions of the same CSIT performance tests across the three
-physical testbeds within LF FD.io labs. Plotted grouped bars illustrate
-the 64B/78B packet throughput speedup ratio for 2- and 4-core multi-
+Speedup Multi-Core throughput graphs are generated by multiple
+executions of the same performance tests across physical testbeds hosted
+LF FD.io labs: 3n-hsw, 2n-skx, 2n-skx. Grouped bars illustrate the
+64B/78B packet throughput speedup ratio for 2- and 4-core multi-
 threaded VPP configurations relative to 1-core configurations.
 
+Additional information about graph data:
+
+#. **Graph Title**: describes tested packet path, testbed topology,
+   processor model, NIC model, packet size used by data plane workers and
+   indication of VPP DUT configuration.
+
+#. **X-axis Labels**: number of cores.
+
+#. **Y-axis Labels**: measured Packets Per Second [pps] throughput
+   values.
+
+#. **Graph Legend**: lists CSIT test suites executed to generate graphed test
+   results.
+
+#. **Hover Information**: lists number of runs executed, specific test
+   substring, mean value of the measured packet throughput, calculated perfect
+   throughput value, difference between measured and perfect values and
+   relative speedup value.
+
 .. note::
 
     Test results have been generated by
     `FD.io test executor vpp performance job 3n-hsw`_,
     `FD.io test executor vpp performance job 3n-skx`_ and
-    `FD.io test executor vpp performance job 2n-skx`_ with Robot Framework
+    `FD.io test executor vpp performance job 2n-skx`_ with RF
     result files csit-vpp-perf-|srelease|-\*.zip
     `archived here <../../_static/archive/>`_.
-    Plotted data set size per test case is equal to the number of job executions
-    presented in this report version: **10**.
+    Required per test case data set size is **10**, but for VPP tests
+    the actual size varies per test case and is <=10.
 
 .. toctree::
-    :maxdepth: 1
+    :maxdepth: 3
 
     l2
     ip4