fix docs

doc/services/identity/v3/application-credentials.rst

@@ -1,6 +1,16 @@
 Application Credentials
 =======================
 
+Application credentials provide a way to delegate a user’s authorization to an application without sharing the user’s
+password authentication. This is a useful security measure, especially for situations where the user’s identification
+is provided by an external source, such as LDAP or a single-sign-on service. Instead of storing user passwords in
+config files, a user creates an application credential for a specific project, with all or a subset of the role assignments
+they have on that project, and then stores the application credential identifier and secret in the config file.
+
+See the `Official documentation <https://docs.openstack.org/keystone/latest/user/application_credentials.html>`_
+
+You must :doc:`create the service <services/identity/v3/create>` first to use this resource.
+
 Create
 ------
 

doc/services/identity/v3/create.rst

@@ -1,14 +1,14 @@
 Create Service
 ==============
 
-Service can be created via ``identityV3()`` method of ``OpenStack`` object:
+Service can be created via ``identityV3()`` method of the ``OpenStack`` object:
 
 .. code-block:: php
 
-    $service = $openstack->identityV3();
+    $identity = $openstack->identityV3();
 
 A list of additional options can be passed to the method. For example, to change the region:
 
 .. code-block:: php
 
-    $service = $openstack->identityV3(['region' => '{region}']);
+    $identity = $openstack->identityV3(['region' => '{region}']);