From 0e780a0d4450faf7e96d90a4f06ee6a7d7861e6e Mon Sep 17 00:00:00 2001
From: "Jarzyna, Andrzej" <Andrzej.Jarzyna@adidas.com>
Date: Tue, 26 Nov 2019 12:48:12 +0100
Subject: [PATCH] Add descriptions

---
 examples/valid/demo-orderapi-v3.oas2.yaml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/examples/valid/demo-orderapi-v3.oas2.yaml b/examples/valid/demo-orderapi-v3.oas2.yaml
index d24ad50..1dab834 100644
--- a/examples/valid/demo-orderapi-v3.oas2.yaml
+++ b/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: