[
https://issues.apache.org/jira/browse/CAMEL-13812?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17064708#comment-17064708
]
Zoran Regvart commented on CAMEL-13812:
---------------------------------------
{quote}I suggest changing Getting started for Getting started with Apache Camel
and deleting Longer Getting Started Guide.{quote}
Not sure about renaming, "Getting started" to "Getting started with Apache
Camel", and about deleting the "Longer Getting Started Guide", what's the value
in that?
{quote}In Documentation (after Summary and Overview) I would suggest the
following order:{quote}
I don't think it makes much sense to keep any of that, the navigation on the
left should be used to access content. We have an issue on making sure that the
linked pages are also available on the navigation (CAMEL-13780).
I like the direction this is heading, especially with the splitting of FAQ into
a separate component/module. Make sure to read Antora documentation on that,
and that you're aware of the {{xref}} link changes that need to be made when
the split is done.
> Split up user manual
> --------------------
>
> Key: CAMEL-13812
> URL: https://issues.apache.org/jira/browse/CAMEL-13812
> Project: Camel
> Issue Type: Sub-task
> Components: documentation, website
> Reporter: Zoran Regvart
> Priority: Major
> Labels: help-wanted
> Fix For: 3.x
>
> Attachments: FAQ landing-page.docx,
> getting-started-with-apache-camel.docx
>
>
> I think we would benefit from splitting up the user manual into even smaller
> Antora modules:
> * FAQ
> * Getting started
> * User manual
> Perhaps (not sure), Architecture. I think grouping of pages would help as we
> could have a landing (index) page for each module.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
