Hi David,

On Tue, Aug 17, 2021 at 7:53 AM David Jencks <[email protected]> wrote:
>
> Related to my proposal to change how component pages are (partially) 
> generated I expect to be proposing to move to the latest Antora 3 alpha.  In 
> particular this has logging and the ability to be configured to fail on log 
> levels, in particular warnings.  This will make the xref-checker obsolete, as 
> logging provides more detailed information.

+1 for replacing the xref-checker, we basically generate the Antora
portion of the website twice, which takes up quite a bit of time; so
removing the xref-checker should speedup the build.

> Currently the warnings and errors from the build are:
>
> [22:44:07.521] WARN (asciidoctor): skipping reference to missing attribute: 
> myclient
>     file: docs/user-manual/modules/ROOT/pages/route-template.adoc
>     source: https://github.com/apache/camel.git (refname: main, start path: 
> docs/user-manual)
[snip]
> Currently this sort of warning is output to the console but cannot be used to 
> fail the build.

Could we use `failure_level`[1] to fail the build? I'm taking it as a
fact that most folk don't go through the build logs so not failing the
build for errors (and we should fail for warnings as well IMHO) leaves
us with a broken website.

zoran
[1] https://docs.antora.org/antora/3.0/playbook/runtime-log-failure-level/
-- 
Zoran Regvart

Reply via email to