Add documentation on top of classes (#924)

* Add documentation on top of classes

* Add changelog

* remove debug code

Author: jderusse

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- Added documentation in class's headers.
+
 ## 1.8.0
 
 ### Added

src/Sts/Result/AssumeRoleResponse.php

@@ -7,6 +7,10 @@
 use AsyncAws\Core\Sts\ValueObject\AssumedRoleUser;
 use AsyncAws\Core\Sts\ValueObject\Credentials;
 
+/**
+ * Contains the response to a successful AssumeRole request, including temporary AWS credentials that can be used to
+ * make AWS requests.
+ */
 class AssumeRoleResponse extends Result
 {
     /**

src/Sts/Result/AssumeRoleWithWebIdentityResponse.php

@@ -7,6 +7,10 @@
 use AsyncAws\Core\Sts\ValueObject\AssumedRoleUser;
 use AsyncAws\Core\Sts\ValueObject\Credentials;
 
+/**
+ * Contains the response to a successful AssumeRoleWithWebIdentity request, including temporary AWS credentials that can
+ * be used to make AWS requests.
+ */
 class AssumeRoleWithWebIdentityResponse extends Result
 {
     /**

src/Sts/Result/GetCallerIdentityResponse.php

@@ -5,6 +5,10 @@
 use AsyncAws\Core\Response;
 use AsyncAws\Core\Result;
 
+/**
+ * Contains the response to a successful GetCallerIdentity request, including information about the entity making the
+ * request.
+ */
 class GetCallerIdentityResponse extends Result
 {
     /**

src/Sts/ValueObject/AssumedRoleUser.php

@@ -2,6 +2,12 @@
 
 namespace AsyncAws\Core\Sts\ValueObject;
 
+/**
+ * The Amazon Resource Name (ARN) and the assumed role ID, which are identifiers that you can use to refer to the
+ * resulting temporary security credentials. For example, you can reference these credentials as a principal in a
+ * resource-based policy by using the ARN or assumed role ID. The ARN and ID include the `RoleSessionName` that you
+ * specified when you called `AssumeRole`.
+ */
 final class AssumedRoleUser
 {
     /**

src/Sts/ValueObject/Credentials.php

@@ -2,6 +2,13 @@
 
 namespace AsyncAws\Core\Sts\ValueObject;
 
+/**
+ * The temporary security credentials, which include an access key ID, a secret access key, and a security (or session)
+ * token.
+ *
+ * > The size of the security token that STS API operations return is not fixed. We strongly recommend that you make no
+ * > assumptions about the maximum size.
+ */
 final class Credentials
 {
     /**

src/Sts/ValueObject/PolicyDescriptorType.php

@@ -2,6 +2,10 @@
 
 namespace AsyncAws\Core\Sts\ValueObject;
 
+/**
+ * A reference to the IAM managed policy that is passed as a session policy for a role session or a federated user
+ * session.
+ */
 final class PolicyDescriptorType
 {
     /**

src/Sts/ValueObject/Tag.php

@@ -4,6 +4,13 @@
 
 use AsyncAws\Core\Exception\InvalidArgument;
 
+/**
+ * You can pass custom key-value pair attributes when you assume a role or federate a user. These are called session
+ * tags. You can then use the session tags to control access to resources. For more information, see Tagging AWS STS
+ * Sessions in the *IAM User Guide*.
+ *
+ * @see https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html
+ */
 final class Tag
 {
     /**