Try to make the nature of Swagger's limitation a clearer

This commit is contained in:
Andy Wilkinson
2017-07-21 21:58:31 +01:00
parent a31fa12f1a
commit d9af12933f

View File

@@ -41,7 +41,8 @@ snippets produced with Spring MVC Test.
Spring REST Docs helps you to document RESTful services. It combines hand-written
documentation written with [Asciidoctor](http://asciidoctor.org/) and auto-generated
snippets produced with [Spring MVC Test](http://docs.spring.io/spring/docs/current/spring-framework-reference/htmlsingle#spring-mvc-test-framework). This approach frees you from the limitations imposed by tools like
snippets produced with [Spring MVC Test](http://docs.spring.io/spring/docs/current/spring-framework-reference/htmlsingle#spring-mvc-test-framework).
This approach frees you from the limitations of the documentation produced by tools like
[Swagger](http://swagger.io/). It helps you to produce documentation that is accurate,
concise, and well-structured. This documentation then allows your users to get the
information they need with a minimum of fuss.