14 files changed, 195 insertions, 133 deletions
diff --git a/docs/conf.py b/docs/conf.py
index adf15cc4a..d042f2ce5 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -3,6 +3,8 @@ from docs_conf.conf import *
 branch = 'latest'
 master_doc = 'index'
 
+doc_url = 'https://docs.onap.org/projects'
+
 linkcheck_ignore = [
     r'http://localhost:.*',
     'http://CONSUL_SERVER_UI:30270/ui/#/dc1/services',
@@ -18,6 +20,7 @@ linkcheck_ignore = [
 ]
 
 intersphinx_mapping = {}
+intersphinx_mapping['onap-oom'] = ('{}/onap-oom/en/%s'.format(doc_url) % branch, None)
 
 html_last_updated_fmt = '%d-%b-%y %H:%M'
 
diff --git a/docs/docs_usecases.rst b/docs/docs_usecases.rst
index f86fc6b11..a8efb0d63 100644
--- a/docs/docs_usecases.rst
+++ b/docs/docs_usecases.rst
@@ -5,24 +5,7 @@
 
 :orphan:
 
-Deprecated Use Cases and Functional Requirements
-================================================
+.. toctree::
+   :maxdepth: 1
 
-Each ONAP release deals with lots of use cases and functional requirements.
-When possible, it is strongly recommended to automate the use cases.
-In this case Integration team can take over the maintenance part of the use case.
-If not automated, the use cases are fully under the responsibility of the use
-case team and usually valid for the release the team was involved in.
-However, these use cases, their artifacts remain in the repository.
-Anyone can give a try even if the use cases are no more supported.
-
-This section deals with such use cases.
-These use cases have been part of one release but have not been tested on the
-last releases. They might fully deprecated or usable through minor adaptations.
-The entry points are the use case owners.
-
-.. csv-table:: deprecated use case table
-    :file: ./files/csv/usecases-deprecated.csv
-    :widths: 50,20,10,20
-    :header-rows: 1
-    :delim: ;
+   usecases/deprecated_usecases.rst
diff --git a/docs/docs_usecases_release.rst b/docs/docs_usecases_release.rst
index 9e662a5a4..ffd954617 100644
--- a/docs/docs_usecases_release.rst
+++ b/docs/docs_usecases_release.rst
@@ -5,8 +5,8 @@
 
 :orphan:
 
-Guilin Use Cases and Functional Requirements
-=============================================
+Guilin Use Cases and Requirements
+=================================
 
 Description
 -----------
@@ -24,59 +24,10 @@ This documentation deals with
      links to download the related assets and resources
   3. Known issues and workarounds
 
-Use cases
----------
+.. toctree::
+   :maxdepth: 1
 
-Guilin New Use Cases
-~~~~~~~~~~~~~~~~~~~~
-
-.. csv-table:: use case table
-   :file: ./files/csv/usecases.csv
-   :widths: 10,40,20,30
-   :delim: ;
-   :header-rows: 1
-
-Old Use Cases Tested in Guilin
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. csv-table:: use case table
-   :file: ./files/csv/usecases-old-valid.csv
-   :widths: 50,20,30
-   :delim: ;
-   :header-rows: 1
-
-Functional Requirements
------------------------
-
-.. csv-table:: functional requirements table
-    :file: ./files/csv/usecases-functional-requirements.csv
-    :widths: 10,40,20,30
-    :delim: ;
-    :header-rows: 1
-
-Automated Use Cases
--------------------
-
-.. csv-table:: Infrastructure Healthcheck Tests
-    :file: ./files/csv/tests-infrastructure-healthcheck.csv
-    :widths: 20,40,20,20
-    :delim: ;
-    :header-rows: 1
-
-.. csv-table:: Healthcheck Tests
-    :file: ./files/csv/tests-healthcheck.csv
-    :widths: 20,40,20,20
-    :delim: ;
-    :header-rows: 1
-
-.. csv-table:: Smoke Tests
-    :file: ./files/csv/tests-smoke.csv
-    :widths: 20,40,20,20
-    :delim: ;
-    :header-rows: 1
-
-.. csv-table:: Security Tests
-    :file: ./files/csv/tests-security.csv
-    :widths: 20,40,20,20
-    :delim: ;
-    :header-rows: 1
+   usecases/release_usecases.rst
+   usecases/release_automated_usecases.rst
+   usecases/release_requirements.rst
+   usecases/release_non_functional_requirements.rst
diff --git a/docs/files/csv/tests-healthcheck.csv b/docs/files/csv/tests-healthcheck.csv
index 0df88a94b..51eddde63 100644
--- a/docs/files/csv/tests-healthcheck.csv
+++ b/docs/files/csv/tests-healthcheck.csv
@@ -3,3 +3,6 @@ core;Robot healthcheck tests of the core components (AA&I, DMAAP, Portal, SDC, S
 full;Robot healthcheck tests for all the components;`robot tests <https://git.onap.org/testsuite/tree/robot/testsuites/health-check.robot>`__;`robotframework <https://robotframework.org/>`__
 healthdist;Check the onboarding and distribution of the vFW;`robot tests <https://git.onap.org/testsuite/tree/robot/testsuites/health-check.robot>`__;`robotframework <https://robotframework.org/>`__
 postinstall;Check dmaap and AA&I Design model DB tests;`robot tests <https://git.onap.org/testsuite/tree/robot/testsuites/post-install-tests.robot>`__;`robotframework <https://robotframework.org/>`__
+cmpv2 (new);CMPv2 Usecase functionality;`code <https://git.onap.org/testsuite/tree/robot/testsuites/cmpv2.robot>`__;`robotframework <https://robotframework.org/>`__
+ves-collector (new);Suite for checking handling events by VES Collector;`code <https://git.onap.org/testsuite/tree/robot/testsuites/ves.robot>`__;`robotframework <https://robotframework.org/>`__
+hv-ves;HV-VES 'Sunny Scenario' Robot Framework test - message is sent to the collector and Kafka topic is checked if the message has been published. Content is decoded and checked.;`code <https://git.onap.org/testsuite/tree/robot/testsuites/hvves-ci.robot>`__;`robotframework <https://robotframework.org/>`__
diff --git a/docs/files/csv/tests-smoke.csv b/docs/files/csv/tests-smoke.csv
index bff73f2b3..a83b5375c 100644
--- a/docs/files/csv/tests-smoke.csv
+++ b/docs/files/csv/tests-smoke.csv
@@ -2,8 +2,5 @@ Tests;Description;Code;Comments
 basic_vm;Onboard, distribute and instantiate an Openstack VM using à la carte BPMN, replaced the former basic_vm test;`code <https://git.onap.org/testsuite/pythonsdk-tests/tree/src/onaptests/scenario/basic_vm.py>`__;`onap_pythonsdk <https://gitlab.com/Orange-OpenSource/lfn/onap/python-onapsdk>`__, `pythonsdk-tests <https://git.onap.org/testsuite/pythonsdk-tests/tree/>`__
 basic_network (new);Onboard, distribute and instantiate a Neutron network;`code <https://git.onap.org/testsuite/pythonsdk-tests/tree/src/onaptests/scenario/basic_network.py>`__;`onap_pythonsdk <https://gitlab.com/Orange-OpenSource/lfn/onap/python-onapsdk>`__, `pythonsdk-tests <https://git.onap.org/testsuite/pythonsdk-tests/tree/>`__
 basic_cnf;Onboard (new), distribute and instantiate a Kubernetes pods;`code <https://git.onap.org/testsuite/pythonsdk-tests/tree/src/onaptests/scenario/basic_cnf.py>`__;`onap_pythonsdk <https://gitlab.com/Orange-OpenSource/lfn/onap/python-onapsdk>`__, `pythonsdk-tests <https://git.onap.org/testsuite/pythonsdk-tests/tree/>`__
-cmpv2 (new);CMPv2 Usecase functionality;`code <https://git.onap.org/testsuite/tree/robot/testsuites/cmpv2.robot>`__;`robotframework <https://robotframework.org/>`__
-ves-collector (new);Suite for checking handling events by VES Collector;`code <https://git.onap.org/testsuite/tree/robot/testsuites/ves.robot>`__;`robotframework <https://robotframework.org/>`__
-hv-ves;HV-VES 'Sunny Scenario' Robot Framework test - message is sent to the collector and Kafka topic is checked if the message has been published. Content is decoded and checked.;`code <https://git.onap.org/testsuite/tree/robot/testsuites/hvves-ci.robot>`__;`robotframework <https://robotframework.org/>`__
 5gbulkpm;5G Bulk PM Usecase functionality;`code <https://git.onap.org/testsuite/tree/robot/testsuites/usecases/5gbulkpm.robot>`__;`robotframework <https://robotframework.org/>`__
 pnf-registrate;Executes the PNF registration test cases including setup and teardown;`code <https://git.onap.org/testsuite/tree/robot/testsuites/pnf-registration.robot>`__;`robotframework <https://robotframework.org/>`__
diff --git a/docs/files/csv/usecases-functional-requirements.csv b/docs/files/csv/usecases-functional-requirements.csv
index 4784f0b1b..dbfc561c3 100644
--- a/docs/files/csv/usecases-functional-requirements.csv
+++ b/docs/files/csv/usecases-functional-requirements.csv
@@ -1,20 +1,16 @@
-Issue key;Summary;Created;Contact
-REQ-352;Extend ORAN A1 Adapter and add A1 Policy Management;27/May/20 2:21 PM;JohnKeeney
-REQ-335;Support for Test Topology Auto Design （NFV Testing Automatic Platform）;27/May/20 3:28 AM;Lei_Huang
-REQ-336;Support for Test Environment Auto Deploy（NFV Testing Automatic Platform）;27/May/20 3:37 AM;Lei_Huang
-REQ-337;Support for Test Task Auto Execution （NFV Testing Automatic Platform）;27/May/20 3:37 AM;Lei_Huang
-REQ-338;Support for Test Result Auto Analysis & Certification （NFV Testing Automatic Platform）;27/May/20 3:38 AM;Lei_Huang
-REQ-339;Container Network Function Test Platform (CNTP): OVP 2.0 support and Enable Network Service testing;27/May/20 4:06 AM;mkr1481
-REQ-388;Interactive documentation aligned with a deployment;02/Jun/20 7:05 AM;eric.debeau
-REQ-329;Guilin-R7 - Support for Intent-based Network;20/May/20 2:29 AM;huangzh
-REQ-384;Define and prove the concept of model driven in the context of CPS;28/May/20 1:35 PM;tfinnerty
-REQ-334;ETSI-Alignment for Guilin and Honolulu;27/May/20 2:08 AM;byungwoojun
-REQ-341;ONAP CNF orchestration - Enhancements;27/May/20 8:15 AM;rajewluk
-REQ-353;"xNF License Management, Guilin R7";27/May/20 2:38 PM;tperala
-REQ-320;5G Service Modeling in R7;07/May/20 6:01 PM;bencheung
-REQ-327;ONAP/3GPP & O-RAN Alignment-Standards Defined Notifications over VES (Guilin);19/May/20 8:43 PM;marge.hillis
-REQ-322;Configuration & Persistency Service in R7;07/May/20 6:15 PM;tfinnerty
-REQ-321;CMPv2 Enhancements for R7;07/May/20 6:06 PM;baniewsk
-REQ-319;PNF PreOnboarding in R7;07/May/20 5:50 PM;bencheung
-REQ-417;Epic task for all logging fix tasks;10/Aug/20 12:59 PM;dmizyn
-REQ-326;Self Serve Control Loops;11/May/20 4:18 PM;csbford
+Issue key;Summary;Contact;Comment
+REQ-381;Bulk PM / PM Data Control Extension;Mark Scott;
+REQ-352;Extend ORAN A1 Adapter and add A1 Policy Management;John Keeney;
+REQ-341;ONAP CNF orchestration - Enhancements;Lukasz Rajewski;
+REQ-338;Support for Test Result Auto Analysis & Certification （NFV Testing Automatic Platform）;Lei Huang;
+REQ-337;Support for Test Task Auto Execution （NFV Testing Automatic Platform）;Lei Huang;
+REQ-336;Support for Test Environment Auto Deploy（NFV Testing Automatic Platform）;Lei Huang;
+REQ-335;Support for Test Topology Auto Design （NFV Testing Automatic Platform）;Lei Huang;
+REQ-334;ETSI-Alignment for Guilin and Honolulu;Byung-Woo Jun;
+REQ-331;Policy Based Filtering;Pam Dragosh;
+REQ-327;ONAP/3GPP & O-RAN Alignment-Standards Defined Notifications over VES (Guilin);Marge Hillis;
+REQ-324;Support xNF Software Upgrade in association to schema updates;Zu Qiang;
+REQ-322;Configuration & Persistency Service in R7;Tony Finnerty;
+REQ-321;CMPv2 Enhancements for R7;Pawel Baniewski;cmpv2 automated test integrated in CI/CD, see :ref:`automated test page <release_automated_usecases>`
+REQ-319;PNF PreOnboarding in R7;Ben Cheung;
+REQ-318;PNF Plug & Play in R7;Ben Cheung;
diff --git a/docs/files/csv/usecases-non-functional-requirements.csv b/docs/files/csv/usecases-non-functional-requirements.csv
index 58574194d..82f4c1614 100644
--- a/docs/files/csv/usecases-non-functional-requirements.csv
+++ b/docs/files/csv/usecases-non-functional-requirements.csv
@@ -1,28 +1,18 @@
-Issue key;Issue id;Summary;Priority;Status;Created
-REQ-402;53055;PoC - TOSCA Defined Control Loop ;High;To Do;01/Jul/20 9:46 AM
-REQ-350;52019;Each ONAP project shall improve its CII Badging score by improving input validation and documenting it in their CII Badging site. ;High;To Do;27/May/20 1:56 PM
-REQ-358;52034;No root (superuser) access to database from application container;High;To Do;27/May/20 4:09 PM
-REQ-376;52056;Flow management must be activated for ONAP.;High;To Do;27/May/20 5:16 PM
-REQ-379;52059;ONAP projects must use only approved and verified base images for their containers;High;To Do;27/May/20 6:41 PM
-REQ-380;52060;ONAP container repository (nexus) must not contain upstream docker images;High;To Do;27/May/20 6:44 PM
-REQ-360;52036;Application config should be fully prepared before starting the application container;High;To Do;27/May/20 4:11 PM
-REQ-361;52037;Continue hardcoded passwords removal;High;To Do;27/May/20 4:12 PM
-REQ-362;52038;All containers must run as non-root user;High;To Do;27/May/20 4:12 PM
-REQ-365;52041;Containers must have no more than one main process;High;To Do;27/May/20 4:14 PM
-REQ-366;52042;Containers must crash properly when a failure occurs;High;To Do;27/May/20 4:14 PM
-REQ-369;52045;Replace nfs share with storage class as a default deployment option;High;To Do;27/May/20 4:15 PM
-REQ-373;52053;ONAP must complete update of the Python language (from 2.7 -> 3.8);High;In Progress;27/May/20 5:07 PM
-REQ-374;52054;ONAP shall use STDOUT for logs collection;High;To Do;27/May/20 5:09 PM
-REQ-382;52069;"Support Pylog repository used by VF-C, Modeling, MultiCloud and OOF";High;To Do;27/May/20 11:22 PM
-REQ-385;52108;IPv4/IPv6 dual stack support in ONAP (Guilin);High;In Progress;28/May/20 2:49 PM
-REQ-351;52020;ONAP must complete update of the java language (from v8 -> v11) ;High;In Progress;27/May/20 1:59 PM
-REQ-359;52035;Container rootfs must be mounted readOnly;High;To Do;27/May/20 4:11 PM
-REQ-364;52040;Replace NodePorts with ingress controller as a default deployment option;High;To Do;27/May/20 4:13 PM
-REQ-377;52057;ONAP must implement IAM solutions.;High;In Progress;27/May/20 5:18 PM
-REQ-363;52039;ONAP components should be able to run without AAF and MSB;High;To Do;27/May/20 4:13 PM
-REQ-370;52046;Components may use HTTP as server and client;High;To Do;27/May/20 4:16 PM
-REQ-348;52017;Requirements about ONAP installation result for Guilin release;High;To Do;27/May/20 1:48 PM
-REQ-368;52044;Service mesh PoC;High;To Do;27/May/20 4:15 PM
-REQ-340;51957;ONAP to support Multi - tenancy ;Medium;To Do;27/May/20 8:08 AM
-REQ-386;52109;Apply common Swagger style and documentation generation tools to create robust ONAP API documentation;Medium;To Do;28/May/20 3:01 PM
-REQ-416;54263;Harbor POC with LNF Team;Medium;To Do;31/Jul/20 7:57 AM
+Issue key;Summary;Contact;Comment
+REQ-386;Apply common Swagger style and documentation generation tools to create robust ONAP API documentation;Andy Mayer;
+REQ-385;IPv4/IPv6 dual stack support in ONAP (Guilin);Damian Nowak;
+REQ-376;Flow management must be activated for ONAP.;Fabian Rouzaut;Marginal progress, it was not possible to collect the flow to setup a matrix flow
+REQ-374;ONAP shall use STDOUT for logs collection;Krzysztof Opasiak; Most components (that are not in maintenance mode) are using now stdout for logs collection. We hope to finish this in next release.
+REQ-373;ONAP must complete update of the Python language (from 2.7 -> 3.8);Pawel Pawlak;Significant progress done in Guilin tracked by weekly version test integrated in CI/CD
+REQ-366;Containers must crash properly when a failure occurs;Sylvain Desbureaux;Good progress to be completed in Honolulu
+REQ-365;Containers must have no more than one main process;Sylvain Desbureaux;
+REQ-362;All containers must run as non-root user;Krzysztof Opasiak;The list of waivers has been significantly reduced in Guilin, progress tracker with root test integrated in all CI/CD chains
+REQ-361;Continue hardcoded passwords removal;Krzysztof Opasiak; Majority of projects use certInitializer for certificate generation. Next subset of passwords removed.
+REQ-360;Application config should be fully prepared before starting the application container;Sylvain Desbureaux;
+REQ-358;No root (superuser) access to database from application container;Krzysztof Opasiak; Nice progress but still some of projects access DB as root.
+REQ-357;ONAP shall increase the number of Docker Benchmark tests;Sylvain Desbureaux;More tests integrated in CI/CD but enhancements expected in Honolulu
+REQ-351;ONAP must complete update of the java language (from v8 -> v11) ;Pawel Pawlak;Significant progress done in Guilin tracked by weekly version test integrated in CI/CD
+REQ-350;Each ONAP project shall improve its CII Badging score by improving input validation and documenting it in their CII Badging site ;Tony L Hansen;
+REQ-349;Each ONAP project shall define code coverage improvements and achieve at least 55% code coverage;Amy Zwarico;
+REQ-340;ONAP to support Multi - tenancy ;Olivier Phenix;
+REQ-323;Each project will update the vulnerable direct dependencies in their code base;Amy Zwarico;
diff --git a/docs/onap-oom-heat.rst b/docs/onap-oom-heat.rst
index d3c82790b..54c226114 100644
--- a/docs/onap-oom-heat.rst
+++ b/docs/onap-oom-heat.rst
@@ -35,7 +35,7 @@ Heat Template Description
 
 The ONAP Integration Project provides a sample HEAT template that
 fully automates the deployment of ONAP using OOM as described in
-OOM documentation, see :ref:`OOM<onap-oom:oom_quickstart_guide>` for details.
+OOM documentation, see :ref:`OOM <onap-oom:oom_quickstart_guide>` for details.
 
 The ONAP OOM HEAT template deploys the entire ONAP platform.  It spins
 up an HA-enabled Kubernetes cluster, and deploys ONAP using OOM onto
diff --git a/docs/release-notes.rst b/docs/release-notes.rst
index 6b00bbb30..db31f8fe8 100644
--- a/docs/release-notes.rst
+++ b/docs/release-notes.rst
@@ -14,7 +14,6 @@ Integration Release Notes
 
 .. important::
 
-
     - Creation of a Guilin Daily CI/CD chain
     - Setup of a staging lab on Azure
     - Setup of a staging lab on Windriver/Intel lab (with performance audit of the Windriver/Intel labs)
@@ -115,10 +114,10 @@ New Guilin repositories:
 - robot-utils
 
 
-Verified Use Cases and Functional Requirements
-----------------------------------------------
+Use Cases and Requirements
+--------------------------
 
-:ref:`Use Cases page <docs_usecases_release>`
+See dedicated :ref:`Guilin Use Cases and requirements page <docs_usecases_release>`
 
 ONAP Maturity Testing Notes
 ---------------------------
diff --git a/docs/usecases/deprecated_usecases.rst b/docs/usecases/deprecated_usecases.rst
new file mode 100644
index 000000000..6d82140db
--- /dev/null
+++ b/docs/usecases/deprecated_usecases.rst
@@ -0,0 +1,28 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License. http://creativecommons.org/licenses/by/4.0
+
+.. _deprecated_usecases:
+
+:orphan:
+
+Deprecated Use Cases and Functional Requirements
+================================================
+
+Each ONAP release deals with lots of use cases and functional requirements.
+When possible, it is strongly recommended to automate the use cases.
+In this case Integration team can take over the maintenance part of the use case.
+If not automated, the use cases are fully under the responsibility of the use
+case team and usually valid for the release the team was involved in.
+However, these use cases, their artifacts remain in the repository.
+Anyone can give a try even if the use cases are no more supported.
+
+This section deals with such use cases.
+These use cases have been part of one release but have not been tested on the
+last releases. They might fully deprecated or usable through minor adaptations.
+The entry points are the use case owners.
+
+.. csv-table:: deprecated use case table
+    :file: ../files/csv/usecases-deprecated.csv
+    :widths: 50,20,10,20
+    :header-rows: 1
+    :delim: ;
diff --git a/docs/usecases/release_automated_usecases.rst b/docs/usecases/release_automated_usecases.rst
new file mode 100644
index 000000000..a53d0c1b4
--- /dev/null
+++ b/docs/usecases/release_automated_usecases.rst
@@ -0,0 +1,36 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License. http://creativecommons.org/licenses/by/4.0
+
+.. _release_automated_usecases:
+
+:orphan:
+
+Automated Use Cases
+-------------------
+
+These use cases have been run on the Daily Guilin CI chains and are used to
+validate the integration of any new dockers in OOM.
+
+.. csv-table:: Infrastructure Healthcheck Tests
+    :file: ../files/csv/tests-infrastructure-healthcheck.csv
+    :widths: 20,40,20,20
+    :delim: ;
+    :header-rows: 1
+
+.. csv-table:: Healthcheck Tests
+    :file: ../files/csv/tests-healthcheck.csv
+    :widths: 20,40,20,20
+    :delim: ;
+    :header-rows: 1
+
+.. csv-table:: Smoke Tests
+    :file: ../files/csv/tests-smoke.csv
+    :widths: 20,40,20,20
+    :delim: ;
+    :header-rows: 1
+
+.. csv-table:: Security Tests
+    :file: ../files/csv/tests-security.csv
+    :widths: 20,40,20,20
+    :delim: ;
+    :header-rows: 1
diff --git a/docs/usecases/release_non_functional_requirements.rst b/docs/usecases/release_non_functional_requirements.rst
new file mode 100644
index 000000000..b3f5a0b54
--- /dev/null
+++ b/docs/usecases/release_non_functional_requirements.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License. http://creativecommons.org/licenses/by/4.0
+
+.. _release_non_functional_requirements:
+
+:orphan:
+
+Non Functional Requirements
+----------------------------
+
+.. csv-table:: non functional requirements table
+    :file: ../files/csv/usecases-non-functional-requirements.csv
+    :widths: 5,45,12,38
+    :delim: ;
+    :header-rows: 1
diff --git a/docs/usecases/release_requirements.rst b/docs/usecases/release_requirements.rst
new file mode 100644
index 000000000..0ec4b1b95
--- /dev/null
+++ b/docs/usecases/release_requirements.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License. http://creativecommons.org/licenses/by/4.0
+
+.. _release_requirements:
+
+:orphan:
+
+Functional Requirements
+-----------------------
+
+.. csv-table:: functional requirements table
+    :file: ../files/csv/usecases-functional-requirements.csv
+    :widths: 5,45,12,38
+    :delim: ;
+    :header-rows: 1
diff --git a/docs/usecases/release_usecases.rst b/docs/usecases/release_usecases.rst
new file mode 100644
index 000000000..d28a653b3
--- /dev/null
+++ b/docs/usecases/release_usecases.rst
@@ -0,0 +1,46 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+   International License. http://creativecommons.org/licenses/by/4.0
+
+.. _release_usecases:
+
+:orphan:
+
+Guilin Use Cases
+================
+
+Description
+-----------
+
+This session includes use cases and functional requirements which have been
+officially verified in Guilin release by the ONAP community.
+
+For each use case or functional requirement, you can find contact names and a
+link to the associated documentation.
+
+This documentation deals with
+
+  1. What has been implemented
+  2. Step by step instructions to deploy and execute the tests, including the
+     links to download the related assets and resources
+  3. Known issues and workarounds
+
+Use cases
+---------
+
+Guilin New Use Cases
+~~~~~~~~~~~~~~~~~~~~
+
+.. csv-table::
+   :file: ../files/csv/usecases.csv
+   :widths: 10,40,20,30
+   :delim: ;
+   :header-rows: 1
+
+Old Use Cases Tested in Guilin
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. csv-table::
+   :file: ../files/csv/usecases-old-valid.csv
+   :widths: 50,20,30
+   :delim: ;
+   :header-rows: 1