Repository: zircote/swagger-php (PHP)

Issue:
Include description as a public property within the PathItem Annotation class
According to [OAS3](https://swagger.io/docs/specification/paths-and-operations/)

> Paths may have an optional short summary **and a longer description** for documentation purposes. This information is supposed to be relevant to all operations in this path. description can be [multi-line](http://stackoverflow.com/questions/3790454/in-yaml-how-do-i-break-a-string-over-multiple-lines) and supports [Markdown](http://commonmark.org/help/) (CommonMark) for rich text representation.

However, the [PathItem](https://github.com/zircote/swagger-php/blob/master/src/Annotations/PathItem.php) Class doesn't include the description field, [the same way it does for the summary](https://github.com/zircote/swagger-php/blob/master/src/Annotations/PathItem.php#L42)

Would it be possible to include description field as well, for example [as it is done under the Response Annotation](https://github.com/zircote/swagger-php/blob/master/src/Annotations/Response.php#L44)


Thanks.



Fix (patch):
diff --git a/src/Annotations/PathItem.php b/src/Annotations/PathItem.php
index aa5f6da85..cfeeeddab 100644
--- a/src/Annotations/PathItem.php
+++ b/src/Annotations/PathItem.php
@@ -28,18 +28,25 @@ class PathItem extends AbstractAnnotation
     public $ref = Generator::UNDEFINED;
 
     /**
-     * Key for the Path Object (OpenApi->paths array).
+     * An optional, string summary, intended to apply to all operations in this path.
      *
      * @var string
      */
-    public $path = Generator::UNDEFINED;
+    public $summary = Generator::UNDEFINED;
 
     /**
-     * An optional, string summary, intended to apply to all operations in this path.
+     * An optional, string description, intended to apply to all operations in this path.
      *
      * @var string
      */
-    public $summary = Generator::UNDEFINED;
+    public $description = Generator::UNDEFINED;
+
+    /**
+     * Key for the Path Object (OpenApi->paths array).
+     *
+     * @var string
+     */
+    public $path = Generator::UNDEFINED;
 
     /**
      * A definition of a GET operation on this path.
diff --git a/src/Attributes/PathItem.php b/src/Attributes/PathItem.php
index 61604ba68..5ba665878 100644
--- a/src/Attributes/PathItem.php
+++ b/src/Attributes/PathItem.php
@@ -20,6 +20,7 @@ class PathItem extends \OpenApi\Annotations\PathItem
     public function __construct(
         ?string $path = null,
         ?string $summary = null,
+        ?string $description = null,
         ?array $servers = null,
         ?array $parameters = null,
         // annotation
@@ -29,10 +30,9 @@ public function __construct(
         parent::__construct([
                 'path' => $path ?? Generator::UNDEFINED,
                 'summary' => $summary ?? Generator::UNDEFINED,
+                'description' => $description ?? Generator::UNDEFINED,
                 'x' => $x ?? Generator::UNDEFINED,
                 'value' => $this->combine($servers, $parameters, $attachables),
             ]);
     }
 }
-
-// Missing parameters: get, put, post, delete, options, head, patch, trace, parameters