anchor.diff:  
   === Using Swagger2Markup
   
  -Using the Swagger2MarkupConverter is simple. For instance, you can generate your AsciiDoc/Markdown documentation using https://github.com/spring-projects/spring-boot[Spring Boot] and https://github.com/springfox/springfox[springfox] during the unit or integration test phase.
  -See demo project https://github.com/RobWin/spring-swagger2markup-demo[spring-swagger2markup-demo] for more details.
  -The demo shows how you can generate static docs (HTML5 and PDF) with Swagger2Markup and serve them as static content in a Spring Boot App under http://localhost:9080/docs/index.html and http://localhost:9080/docs/index.pdf.
  +Using the Swagger2MarkupConverter is simple. For example, you can generate your AsciiDoc/Markdown documentation using https://github.com/spring-projects/spring-boot[Spring Boot] and https://github.com/springfox/springfox[springfox] during the unit or integration test phase.
  +The quickest way to get started is to look at the demo project https://github.com/RobWin/spring-swagger2markup-demo[spring-swagger2markup-demo]. The demo shows how to generate static docs (HTML5 and PDF) with Swagger2Markup and serve them as static content in a Spring Boot App under http://localhost:9080/docs/index.html and http://localhost:9080/docs/index.pdf.
   
   ==== Integration Test
   [source,java]
  
positive.code: 
  You can use Swagger2Markup to convert your design-first Swagger YAML into a human-readable format and mix it with hand-written documentation. As an alternative, you can choose the implementation-first approach and use Swagger2Markup together with https://github.com/springfox/springfox[springfox] and https://github.com/spring-projects/spring-restdocs[spring-restdocs]. See usage guide below and <<integration-with-spring-restdocs, Integration with spring-restdocs>>.
  
  You can generate your HTML5 and PDF documentation via https://github.com/asciidoctor/asciidoctorj[asciidoctorj] or even better via the https://github.com/asciidoctor/asciidoctor-gradle-plugin[asciidoctor-gradle-plugin] or https://github.com/aalmiray/markdown-gradle-plugin[markdown-gradle-plugin].
  You can also use https://github.com/jbake-org/jbake[JBake], https://github.com/tomchristie/mkdocs[MkDocs] or https://github.com/rtfd/readthedocs.org[ReadTheDocs] to publish your AsciiDoc or Markdown documentation.
  
  The project requires at least JDK 7.
  
  
negative.code: }
  ----
  
  ==== Unit Test
  
  Spring's MVC Test framework can also be used to make a request to the Springfox Swagger endpoint of the RESTful service that you are documenting. A custom ResultHandler is used to automatically convert the Swagger JSON response into an AsciiDoc document.
  That way you test that your Springfox Swagger endpoint is working, too.
  
  [source,java]
  ----
  @WebAppConfiguration
  