anchor.diff:  org.springframework.restdocs.outputDir = src/docs/asciidoc/generated
   ----
   
  -The Swagger2MarkupConverter must know the output directory of spring-restdocs.
  +The Swagger2MarkupConverter must know the base output directory of spring-restdocs.
   
   [source,java]
   ----
  
positive.code: [source,java]
  ----
  Swagger2MarkupConverter.from("http://localhost:8080/api-docs").
                  withMarkupLanguage(MarkupLanguage.MARKDOWN).
                  withExamples("docs/generated").withSchemas("docs/schemas").build()
                  .intoFolder("src/docs/markdown");
  ----
  
  I create the Schemas files in Unit-Tests as follows:
  
  [source,java]
  ----
          RestDocumented restDocumented = RestDocumented.fromProperties();
          restDocumented.documentJsonSchema(MailStorageQuota.class, "docs/schemas");
          restDocumented.documentXmlSchema(MailStorageQuota.class, "docs/schemas");
  ----
  
  I will make RestDocumented public soon. RestDocumented creates a MailStorageQuota.xsd and MailStorageQuota.json file in the folder `docs/schemas`.
  The Swagger2MarkupConverter will include the JSON and XML Schemas, if a Swagger Operation uses the MailStorageQuota class as Input or Output.
  
  See example: http://spring-swagger2markup-demo.readthedocs.org/en/latest/generated/definitions/[ReadTheDocs-demo]
  
negative.code: 
  
  == Integration with spring-restdocs
  Swagger2Markup can be used together with https://github.com/spring-projects/spring-restdocs[spring-restdocs].
  Swagger2Markup can include the generated HTTP request and response 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 only support AsciiDoc.
  
  Let's say you have a Swagger-annotated Spring RestController method with an ApiOperation value: `Add a new pet to the store`
  
  