Fixed code review

Author: haphan

src/Identity/v3/Models/Token.php

@@ -121,19 +121,16 @@ public function create(array $data): Creatable
         $response = $this->execute($this->api->postTokens(), $data);
         $token = $this->populateFromResponse($response);
 
-
-        /**
-         * Cache response as an array to export if needed.
-         *  Added key `id` which is auth token from HTTP header X-Subject-Token
-         */
+        // Cache response as an array to export if needed.
+        // Added key `id` which is auth token from HTTP header X-Subject-Token
         $this->cachedToken = Utils::flattenJson(Utils::jsonDecode($response), $this->resourceKey);
         $this->cachedToken['id'] = $token->id;
 
         return $token;
     }
 
     /**
-     * Retrieves an array serializable representation of authentication token.
+     * Returns a serialized representation of an authentication token.
      *
      * Initialize OpenStack object using $params['cachedToken'] to reduce HTTP authentication call.
      *

src/Identity/v3/Service.php

@@ -60,7 +60,6 @@ public function authenticate(array $options): array
      * @param array $cachedToken {@see \OpenStack\Identity\v3\Models\Token::export}
      *
      * @return Models\Token
-     *
      */
     public function generateTokenFromCache(array $cachedToken): Models\Token
     {