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.2.0
 
 ### Added

src/Enum/InvocationType.php

@@ -2,6 +2,15 @@
 
 namespace AsyncAws\Lambda\Enum;
 
+/**
+ * Choose from the following options.
+ *
+ * - `RequestResponse` (default) - Invoke the function synchronously. Keep the connection open until the function
+ *   returns a response or times out. The API response includes the function response and additional data.
+ * - `Event` - Invoke the function asynchronously. Send events that fail multiple times to the function's dead-letter
+ *   queue (if it's configured). The API response only includes a status code.
+ * - `DryRun` - Validate parameter values and verify that the user or role has permission to invoke the function.
+ */
 final class InvocationType
 {
     public const DRY_RUN = 'DryRun';

src/Enum/LogType.php

@@ -2,6 +2,9 @@
 
 namespace AsyncAws\Lambda\Enum;
 
+/**
+ * Set to `Tail` to include the execution log in the response.
+ */
 final class LogType
 {
     public const NONE = 'None';

src/Enum/Runtime.php

@@ -2,6 +2,9 @@
 
 namespace AsyncAws\Lambda\Enum;
 
+/**
+ * A runtime identifier. For example, `go1.x`.
+ */
 final class Runtime
 {
     public const DOTNETCORE_1_0 = 'dotnetcore1.0';

src/ValueObject/LayerVersionContentInput.php

@@ -2,6 +2,9 @@
 
 namespace AsyncAws\Lambda\ValueObject;
 
+/**
+ * The function layer archive.
+ */
 final class LayerVersionContentInput
 {
     /**

src/ValueObject/LayerVersionContentOutput.php

@@ -2,6 +2,9 @@
 
 namespace AsyncAws\Lambda\ValueObject;
 
+/**
+ * Details about the layer version.
+ */
 final class LayerVersionContentOutput
 {
     /**

src/ValueObject/LayerVersionsListItem.php

@@ -4,6 +4,11 @@
 
 use AsyncAws\Lambda\Enum\Runtime;
 
+/**
+ * Details about a version of an AWS Lambda layer.
+ *
+ * @see https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html
+ */
 final class LayerVersionsListItem
 {
     /**