anchor.diff:  
   == Integration with spring-restdocs
   https://github.com/spring-projects/spring-restdocs[spring-restdocs] can be used together with Swagger2Markup.
  -Swagger2Markup can include the generated examples from spring-restdocs into the generated AsciiDoc document.
  -Currently it does not work for Markdown, since spring-restdocs generates only AsciiDoc files.
  +Swagger2Markup can include the generated examples snippets from spring-restdocs into the generated AsciiDoc document.
  +See https://github.com/spring-projects/spring-restdocs[spring-restdocs] how to configure it.
  +Currently spring-restdocs does not work support Markdown.
   
   Let's say I have a Swagger-annotated Spring RestController method with an ApiOperation value: _"Create a quota"_
   
  
positive.code: 
  image::images/generated_docs.PNG[generated_docs]
  
  You can generate your HTML5 and PDF documentation via the https://github.com/asciidoctor/asciidoctor-gradle-plugin[asciidoctor-gradle-plugin]. The following shows how to configure the asciidoctor-gradle-plugin. By default it searches for AsciiDoc files in "src/docs/asciidoc" and puts the HTML and PDF output into "build/asciidoc/html5" and "build/asciidoc/pdf".
  
  [source]
  ----
  
negative.code: public void createMailStorageQuota(@ApiParam(name = "MailStorageQuota",
      value = "MailStorageQuota", required = true) @RequestBody MailStorageQuota mailStorageQuota) {
  }
  
  
  ----
  
  I'm using spring-restdocs in combination with https://github.com/jayway/rest-assured to test the Controller.
  The target folder of the generated request and response example files must be _"create_a_quota"_ (similar to the value of the ApiOperation, but with underscores and lowercase).
  
  [source,java]
  ----
  