From 4006186227086db24bacc9ca546bc14ebff698a6 Mon Sep 17 00:00:00 2001
From: morganrol <morgan.richomme@orange.com>
Date: Fri, 12 Feb 2021 12:08:34 +0100
Subject: [PATCH] [DOC] Improve automated tests doc section

After some remaks after the demo session, it is possible to
improve the documentation

Issue-ID: TEST-289

Signed-off-by: morganrol <morgan.richomme@orange.com>
Change-Id: Ibc4c153ff6bcc1a0f600686179b2deebd7d28515
---
 docs/files/csv/usecases-deprecated.csv |  2 +-
 docs/integration-tests.rst             | 26 +++++++++++++++++++-------
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/docs/files/csv/usecases-deprecated.csv b/docs/files/csv/usecases-deprecated.csv
index 713d6d716..7b84dd4ab 100644
--- a/docs/files/csv/usecases-deprecated.csv
+++ b/docs/files/csv/usecases-deprecated.csv
@@ -24,6 +24,6 @@ VSP Compliance and Validation Check within SDC;`wiki page <https://wiki.onap.org
 Enable PNF software version at onboarding;`wiki page <https://jira.onap.org/browse/REQ-88?src=confmacro>`__;Frankfurt;No tested in Guilin
 xNF communication security enhancements; `wiki page <https://wiki.onap.org/display/DW/xNF+communication+security+enhancements+-+Tests+Description+and+Status>`__;Frankfurt;No tested in Guilin
 ETSI Alignment SO plugin to support SOL003 to connect to an external VNFM;`wiki page <https://wiki.onap.org/display/DW/ETSI+Alignment+Support>`__;Frankfurt;No tested in Guilin
-Integration of CDS as an Actor; `official doc <https://docs.onap.org/projects/onap-ccsdk-cds/en/latest/ui/designer.html>`_;Frankfurt;No tested in Guilin
+Integration of CDS as an Actor; `official doc <https://docs.onap.org/projects/onap-ccsdk-cds/en/latest/ui/designer-guide.html>`_;Frankfurt;No tested in Guilin
 3rd Party Operational Domain Manager; `wiki page <https://wiki.onap.org/display/DW/Third-party+Operational+Domain+Manager>`__;Frankfurt;No tested in Guilin
 Configuration & persistency; `wiki page <https://wiki.onap.org/pages/viewpage.action?pageId=64003184>`__;Frankfurt;No tested in Guilin
diff --git a/docs/integration-tests.rst b/docs/integration-tests.rst
index ece001f59..62235e04d 100644
--- a/docs/integration-tests.rst
+++ b/docs/integration-tests.rst
@@ -79,6 +79,8 @@ All the pages and artifacts are pushed to LF backend:
 - Weekly chains: https://logs.onap.org/onap-integration/weekly
 - Gating chains: https://logs.onap.org/onap-integration/gating
 
+A video has been recorded to help launching some of the automated tests on ONAP Guilin.
+See `Running ONAP tests in Guilin Video <https://www.youtube.com/watch?v=ABvuJfyGDmw>`_
 
 Infrastructure Healthcheck Tests
 ................................
@@ -119,17 +121,27 @@ Smoke Tests
     :delim: ;
     :header-rows: 1
 
-See `Python smoke test README <https://git.onap.org/integration/xtesting/tree/smoke-usecases-robot/README.md>`_
-to adapt and run robot based smoke tests.
-An html page is generated by the pythonsdk-test tests.
-
-.. figure:: files/tests/test-basic-cnf.png
+There are 2 main families of smoke tests:
 
+* RobotFramework based tests, usually run from inside the cluster as a k8s job
+* Pythonsdk based tests. These tests (also known as onaptests) are consuming
+  several SDKs: the Openstack and Kubernetes SDK for the management of the cloud
+  resources and the python ONAP SDK for the interactions with ONAP
 
-See `Robot smoke test README <https://git.onap.org/integration/xtesting/tree/smoke-usecases-pythonsdk/README.md>`_
-to adapt and run python-onapsdk based smoke tests.
+To launch the the robot based tests, please see
+`Robot smoke test README <https://git.onap.org/integration/xtesting/tree/smoke-usecases-robot/README.md>`_
 Standard Robot html pages are generated. See :ref:`Robot page <docs_robot>`.
 
+To launch the pythonsdk based tests, please see
+`Python smoke test README <https://git.onap.org/integration/xtesting/tree/smoke-usecases-pythonsdk/README.md>`_
+
+.. note:
+    Please note that the OpenStack minimal version is pike.
+
+An html page is generated by the pythonsdk-test tests.
+
+.. figure:: files/tests/test-basic-cnf.png
+
 Security Tests
 ...............
 
-- 
2.16.6