Test case descriptions for Tempest smoke tests

Adding a high-level description of the Tempest smoke tests.
As agreed on the last Dovetail call, we are aiming for a relatively low
level of detail and instead point to available documentation. As the
tests themselves are quite simple of read, this is the best,
most concise, and up-to-date version of documentation we can find.

JIRA: DOVETAIL-599

Change-Id: I985592c55fd415e254e70db6c6480c7bf3670a29
Signed-off-by: dimitris.tsiolakis <dmts@intracom-telecom.com>

1 files changed, 83 insertions, 0 deletions

diff --git a/docs/testing/user/testspecification/tempest_identity_v3/index.rst b/docs/testing/user/testspecification/tempest_identity_v3/index.rst
new file mode 100644
index 00000000..e5e8f901
--- /dev/null
+++ b/docs/testing/user/testspecification/tempest_identity_v3/index.rst
@@ -0,0 +1,83 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Ericsson AB
+
+===========================================
+Tempest Identity v3 test specification
+===========================================
+
+
+Scope
+=====
+
+The Tempest Identity v3 test area evaluates the ability of the System Under Test
+(SUT) to create, list, delete and verify users through the life of a VNF.
+The tests in this test area will evaluate IPv4 network runtime operations
+functionality.
+
+These runtime operations may include that create, list, verify and delete:
+
+- credentials
+- domains
+- endpoints
+- user groups
+- policies
+- regions
+- roles
+- services
+- identities
+- API versions
+
+References
+==========
+
+`Identity API v3.0 <https://developer.openstack.org/api-ref/identity/v3/index.html.`_
+
+System Under Test (SUT)
+=======================
+
+The system under test is assumed to be the NFVi and VIM in operation on a
+Pharos compliant infrastructure.
+
+Test Area Structure
+===================
+
+The test area is structured in individual tests as listed below.
+For detailed information on the individual steps and assertions performed
+by the tests, review the Python source code accessible via the following links:
+
+All these test cases are included in the test case dovetail.tempest.identity_v3 of
+OVP test suite.
+
+- `Create, Get, Update and Delete Credentials <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_credentials.py#L21>`_
+    - tempest.api.identity.admin.v3.test_credentials.CredentialsTestJSON.test_credentials_create_get_update_delete
+
+- `Create and Verify  Domain <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_domains.py#L159>`_
+    - tempest.api.identity.admin.v3.test_domains.DefaultDomainTestJSON.test_default_domain_exists
+
+- `Create, Update and Delete Domain <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_domains.py>`_
+    - tempest.api.identity.admin.v3.test_domains.DomainsTestJSON.test_create_update_delete_domain
+
+- `Create and Update endpoint <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_endpoints.py>`_
+    - tempest.api.identity.admin.v3.test_endpoints.EndPointsTestJSON.test_update_endpoint
+
+- `Create, List and Delete Group Users <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_groups.py>`_
+    - tempest.api.identity.admin.v3.test_groups.GroupsV3TestJSON.test_group_users_add_list_delete
+
+- `Update Policy <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_policies.py>`_
+    - tempest.api.identity.admin.v3.test_policies.PoliciesTestJSON.test_create_update_delete_policy
+
+- `Create a Region with a Specific Id <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_regions.py>`_
+    - tempest.api.identity.admin.v3.test_regions.RegionsTestJSON.test_create_region_with_specific_id
+
+- `Create, Update and Show Role List <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_roles.py>`_
+    - tempest.api.identity.admin.v3.test_roles.RolesV3TestJSON.test_role_create_update_show_list
+
+- `Create a Service <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_services.py>`_
+    - tempest.api.identity.admin.v3.test_services.ServicesTestJSON.test_create_update_get_service
+
+- `Create and List Trusts <https://github.com/openstack/tempest/blob/12.2.0/tempest/api/identity/admin/v3/test_trusts.py#L193>`_
+    - tempest.api.identity.admin.v3.test_trusts.TrustsV3TestJSON.test_get_trusts_all
+
+- `List API Versions <https://github.com/openstack/tempest/blob/18.0.0/tempest/api/identity/v3/test_api_discovery.py>`_
+    - tempest.api.identity.v3.test_api_discovery.TestApiDiscovery.test_list_api_versions
\ No newline at end of file