[jira] [Resolved] (CAMEL-13588) Fix all errors/warnings in Asciidoc files

["Zoran Regvart (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/CAMEL-13588?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Zoran Regvart resolved CAMEL-13588.
-----------------------------------
    Resolution: Fixed

As a part of the build in the Camel git repository we now escape the documentation in Javadoc when generating the Asciidoc files. Currently in the build we have no asciidoctor warnings.

> Fix all errors/warnings in Asciidoc files
> -----------------------------------------
>
>                 Key: CAMEL-13588
>                 URL: https://issues.apache.org/jira/browse/CAMEL-13588
>             Project: Camel
>          Issue Type: Sub-task
>          Components: documentation
>            Reporter: Zoran Regvart
>            Priority: Major
>
> When building the website a number of errors/warnings are issued from Antora like:
> {code}
> 08:44:06  asciidoctor: WARNING: skipping reference to missing attribute: basedir
> 08:44:06  asciidoctor: WARNING: skipping reference to missing attribute: provisionedthroughputdescription
> {code}
> Or:
> {code}
> 08:44:16  asciidoctor: ERROR: mock-component.adoc: line 269: include target not found: ../../test/java/org/apache/camel/processor/interceptor/AdviceWithMockEndpointsTest.java
> 08:44:16  asciidoctor: ERROR: mock-component.adoc: line 278: include target not found: ../../test/java/org/apache/camel/processor/interceptor/AdviceWithMockEndpointsTest.java
> {code}
> As seen in the [website build #12|https://builds.apache.org/view/C/view/Apache%20Camel/job/Camel.website/job/master/12/console].
> We need to go through the .adoc files in the camel git repository and try to fix as much of those issues as possible. Ideally there shouldn't be any issues reported and we can implement a gate in the website build so that it fails if there are any issues reported so we don't introduce new issues with changes to the documentation.



--
This message was sent by Atlassian JIRA
(v7.6.14#76016)