Add descriptions

examples/valid/demo-orderapi-v3.oas2.yaml

@@ -54,6 +54,7 @@ paths:
 
     get:
       summary: Retrieve List of Orders
+      description: Retrieves a list of orders with pagination.
       parameters:
         - $ref: '#/parameters/offset'
         - $ref: '#/parameters/limit'
@@ -65,6 +66,7 @@ paths:
 
     post:
       summary: Create a New Order
+      description: Creates a new order.
       consumes:
         - application/json
       parameters:
@@ -93,6 +95,7 @@ paths:
 
     get:
       summary: Retrieve Order
+      description: Retrieves an order with specified fields.
       parameters:
         - $ref: '#/parameters/fields'
       responses:
@@ -117,6 +120,7 @@ paths:
 
     patch:
       summary: Update Order
+      description: Does a partial update of an order.
       consumes:
         - application/json
       parameters:
@@ -134,6 +138,7 @@ paths:
 
     delete:
       summary: Delete Order
+      description: Deletes an order without returning its instance.
       produces: []
       responses:
         204: