asciidoctor / asciidoctor-gradle-plugin

A Gradle plugin that uses Asciidoctor via JRuby to process AsciiDoc source files within the project.
https://asciidoctor.github.io/asciidoctor-gradle-plugin/
Apache License 2.0
283 stars 120 forks source link

Property "inProcess" is no longer available while updating to 4.0.0 #698

Open VolkerHartmann opened 6 months ago

VolkerHartmann commented 6 months ago

Thank you very much for providing this great plugin.

However, when updating to the latest version (4.0.0) a problem has now arisen. An error was thrown when building: 'Could not set unknown property 'inProcess' for task ':asciidoctor' of type org.asciidoctor.gradle.jvm.AsciidoctorTask.'

The new feature (executionMode) is documented in the current documentation. However, this is not yet online (https://asciidoctor.github.io/asciidoctor-gradle-plugin/).

Is there a migration guide? It would be helpful if it would at least appear in the release notes.

ysb33r commented 6 months ago

@abelsromero Do you know how the documentation is promoted to the Asciidoctor site?

mojavelinux commented 6 months ago

Not yet. In fact, the migration was never identified as completed. If it is, we can proceed. But all xrefs do need to be valid or else it will stop the build.

abelsromero commented 6 months ago

Yes, not in the site, for now just publish in gh pages as already done. The issue back in the day was the docs are not "per branch" as the other repos, but docs for all versions are in a single one https://github.com/asciidoctor/asciidoctor-gradle-plugin/tree/gh-pages. I'd like to migrate to the other model if no one objects https://github.com/asciidoctor/asciidoctor-gradle-plugin/pull/601#issuecomment-1878369157. Some docs will be duplicated but the reduced mental load when keeping an eye on multiple repos is something I'd appreciate.