Warn against the use of org.asciidoctor.convert 1.5.6
Closes
@@ -25,6 +25,11 @@ been generated for a specific operation. It is made available by including
`spring-restdocs-asciidoctor` in your project's <<getting-started-build-configuration,
build configuration>>.
+WARNING: If you are using Gradle and its daemon or support for continuous builds, do not
+use version 1.5.6 of the `org.asciidoctor.convert` plugin. It contains a
+https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues/222[regression] that
+prevents extensions from working reliably.
+
The target of the macro is the name of the operation. The `snippets` attribute can be
used to select the snippets that should be included using a comma-separated list.
Each entry in the list should be the name of a snippet file, minus the `.adoc` suffix,
