[ 
https://issues.apache.org/jira/browse/CAMEL-13780?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17057785#comment-17057785
 ] 

Zoran Regvart commented on CAMEL-13780:
---------------------------------------

[~aashnajena] that would be perfect. Let me try to explain the issue better. We 
seem to have a number of documents that are only linked from the 
[{{user-manual/modules/ROOT/pages/index.adoc}}|https://github.com/apache/camel/blob/master/docs/user-manual/modules/ROOT/pages/index.adoc]
 and not present in the corresponding module 
[{{nav.adoc}}|https://github.com/apache/camel/blob/master/docs/user-manual/modules/ROOT/nav.adoc].
 

This is caused by the mix of manual and automatic conversion of the 
documentation from the 
[wiki|https://cwiki.apache.org/confluence/display/CAMEL/Documentation] into 
Asciidoc format in the git repository. We simply forgot to update the 
{{nav.adoc}} both to structure the content in chapters and to include all the 
documents we have in the user manual.

The end result of that is that the left hand side navigation doesn't include 
all the documents we have in the user manual and it's difficult for folk to 
reach those documents.

> Cleanup nav.adoc in Antora modules
> ----------------------------------
>
>                 Key: CAMEL-13780
>                 URL: https://issues.apache.org/jira/browse/CAMEL-13780
>             Project: Camel
>          Issue Type: Sub-task
>          Components: documentation
>            Reporter: Zoran Regvart
>            Priority: Major
>              Labels: help-wanted
>             Fix For: 3.2.0
>
>
> The nav.adoc files in user-manual and component reference could use updating. 
> There are documents missing from them and content could be grouped in topics.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to