From 80bb6328494682bc93420710d4866eaf4a90b7c7 Mon Sep 17 00:00:00 2001 From: Andy Wilkinson Date: Mon, 5 Feb 2018 12:25:12 +0000 Subject: [PATCH] Warn against the use of org.asciidoctor.convert 1.5.6 Closes gh-438 --- docs/src/docs/asciidoc/working-with-asciidoctor.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/src/docs/asciidoc/working-with-asciidoctor.adoc b/docs/src/docs/asciidoc/working-with-asciidoctor.adoc index 642172d4..59a02030 100644 --- a/docs/src/docs/asciidoc/working-with-asciidoctor.adoc +++ b/docs/src/docs/asciidoc/working-with-asciidoctor.adoc @@ -25,6 +25,11 @@ been generated for a specific operation. It is made available by including `spring-restdocs-asciidoctor` in your project's <>. +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,