From f538208fd010427f6c34a9c068461bee1513afd1 Mon Sep 17 00:00:00 2001
From: Juho Teperi <juho.teperi@iki.fi>
Date: Tue, 24 Mar 2020 12:28:22 +0200
Subject: [PATCH] Add note about Swagger-UI 3.x :responses

---
 doc/ring/swagger.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/ring/swagger.md b/doc/ring/swagger.md
index cf45e231..ade798ff 100644
--- a/doc/ring/swagger.md
+++ b/doc/ring/swagger.md
@@ -65,6 +65,10 @@ Webjars also hosts a [version](https://github.com/webjars/swagger-ui) of the swa
 
 **NOTE:** If you want to use swagger-ui 2.x you can do so by explicitly downgrading `metosin/ring-swagger-ui` to `2.2.10`.
 
+**NOTE:** If you use swagger-ui 3.x, you need to include `:responses` for Swagger-UI
+to display the response when trying out endpoints. You can define `:responses {200 {:schema s/Any}}`
+at the top-level to show responses for all endpoints.
+
 ## Examples
 
 ### Simple example