docs: Remove hyperlinks to docs in artifacts

It is possible to use sphinx cross referencing
feature in case, that only one level of toctree
is used. Thus documentation was reorganized
to utilize just one top level index with toctree.
After that it was possible to use rst native syntax
to create a cross links among vsperf documentation
chapters. As a result only 2 hyperlinks to the
yardstick documentation are version specific.

JIRA: VSPERF-442

Change-Id: I15c2f53922e88765506448de61af4a299f5d53c5
Signed-off-by: Martin Klozik <martinx.klozik@intel.com>
Reviewed-by: Al Morton <acmorton@att.com>
Reviewed-by: Christian Trautman <ctrautma@redhat.com>
Reviewed-by: Bill Michalowski <bmichalo@redhat.com>
Reviewed-by: Antonio Fischetti <antonio.fischetti@intel.com>
Reviewed-by: Sridhar Rao <sridhar.rao@spirent.com>
Reviewed-by: Martin Goldammer <martinx.goldammer@intel.com>
Reviewed-by: Trevor Cooper <trevor.cooper@intel.com>

4 files changed, 12 insertions, 25 deletions

diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst
deleted file mode 100644
index b4c8575e..00000000
--- a/docs/configguide/index.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) OPNFV, Intel Corporation, AT&T and others.
-
-******************************
-VSPERF Installation Guide
-******************************
-
-.. toctree::
-   :numbered:
-   :maxdepth: 3
-
-   installation.rst
-   upgrade.rst
-   trafficgen.rst
diff --git a/docs/configguide/installation.rst b/docs/configguide/installation.rst
index dd74f293..0578f15b 100644
--- a/docs/configguide/installation.rst
+++ b/docs/configguide/installation.rst
@@ -2,6 +2,8 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. (c) OPNFV, Intel Corporation, AT&T and others.
 
+.. _vsperf-installation:
+
 ======================
 Installing vswitchperf
 ======================
@@ -120,6 +122,8 @@ Changelog of vloop-vnf:
 
     * version with development tools required for build of DPDK and l2fwd
 
+.. _vsperf-installation-script:
+
 Installation
 ------------
 
diff --git a/docs/configguide/trafficgen.rst b/docs/configguide/trafficgen.rst
index d1880f00..3c33d4ef 100644
--- a/docs/configguide/trafficgen.rst
+++ b/docs/configguide/trafficgen.rst
@@ -2,6 +2,8 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. (c) OPNFV, Intel Corporation, AT&T and others.
 
+.. _trafficgen-installation:
+
 ===========================
 'vsperf' Traffic Gen Guide
 ===========================
@@ -87,6 +89,8 @@ commandline above to:
     $ ./vsperf --test-params "TRAFFICGEN_PKT_SIZES=(x,y);TRAFFICGEN_DURATION=10;" \
                              "TRAFFICGEN_RFC2544_TESTS=1" $TESTNAME
 
+.. _trafficgen-dummy:
+
 Dummy
 -----
 
diff --git a/docs/configguide/upgrade.rst b/docs/configguide/upgrade.rst
index 3a970c6a..cf92572c 100644
--- a/docs/configguide/upgrade.rst
+++ b/docs/configguide/upgrade.rst
@@ -120,9 +120,7 @@ options:
 
 In case that any of these options is defined, then configuration must be updated.
 All paths to the tools are now stored inside ``PATHS`` dictionary. Please
-refer to the paths-documentation_ and update your configuration where necessary.
-
-.. _paths-documentation: http://artifacts.opnfv.org/vswitchperf/docs/index.html#configuration-of-paths-dictionary
+refer to the :ref:`paths-documentation` and update your configuration where necessary.
 
 Configuration change via CLI
 ============================
@@ -134,7 +132,7 @@ possible to modify any configuration parameter via CLI or via **Parameters**
 section of the testcase definition. Old configuration options were obsoleted
 and it is required to specify configuration parameter name in the same form
 as it is defined inside configuration file, i.e. in uppercase. Please
-refer to the overriding-parameters-documentation_ for additional details.
+refer to the :ref:`overriding-parameters-documentation` for additional details.
 
 **NOTE:** In case that execution of VSPERF is automated by scripts (e.g. for
 CI purposes), then these scripts must be checked and updated too. It means,
@@ -154,12 +152,9 @@ match to data types of original values from configuration files.
 
 In case that ``guest_nic1_name`` or ``guest_nic2_name`` is changed,
 then new dictionary ``GUEST_NICS`` must be modified accordingly.
-Please see guest-configuration_ and ``conf/04_vnf.conf`` for additional
+Please see :ref:`configuration-of-guest-options` and ``conf/04_vnf.conf`` for additional
 details.
 
-.. _overriding-parameters-documentation: http://artifacts.opnfv.org/vswitchperf/docs/index.html#overriding-values-defined-in-configuration-files
-.. _guest-configuration: http://artifacts.opnfv.org/vswitchperf/docs/index.html#configuration-of-guest-options
-
 Traffic configuration via CLI
 =============================
 
@@ -167,7 +162,7 @@ In previous releases it was possible to modify selected attributes of generated
 traffic via command line interface. This concept has been enhanced in Danube
 release and it is now possible to modify all traffic specific options via
 CLI or by ``TRAFFIC`` dictionary in configuration file. Detailed description
-is available at configuration-of-traffic-dictionary_ section of documentation.
+is available at :ref:`configuration-of-traffic-dictionary` section of documentation.
 
 Please check your automated scripts for VSPERF execution for following CLI
 parameters and update them according to the documentation:
@@ -186,4 +181,3 @@ parameters and update them according to the documentation:
    stream_type
    traffic_type
 
-.. _configuration-of-traffic-dictionary: http://artifacts.opnfv.org/vswitchperf/docs/index.html#configuration-of-traffic-dictionary