anchor.diff:  [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:
  +                withExamples("src/docs/asciidoc/generated").withSchemas("src/docs/schemas").build()
  +                .intoFolder("src/docs/asciidoc");
  +----
  +
  +You can create the schema files during a unit test 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]
  +        restDocumented.documentJsonSchema(MailStorageQuota.class, "src/docs/schemas");
  +        restDocumented.documentXmlSchema(MailStorageQuota.class, "src/docs/schemas");
  +----
  +
  +I will make RestDocumented public soon. RestDocumented creates a MailStorageQuota.xsd and MailStorageQuota.json file in the folder `src/docs/schemas`. The Swagger2MarkupConverter will include the JSON and XML Schemas, if a Swagger Operation uses the MailStorageQuota class as input or output.
  
positive.code: org.springframework.restdocs.outputDir = src/docs/asciidoc/generated
  ----
  
  The Swagger2MarkupConverter must know the output directory of spring-restdocs.
  
  [source,java]
  ----
  
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`
  
  