[
https://issues.apache.org/jira/browse/CAMEL-13812?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17070553#comment-17070553
]
David Jencks commented on CAMEL-13812:
--------------------------------------
I'm sorry I missed this issue when it was filed.
I strongly object to splitting the user manual content into additional
components. I think the result will be too fractured and hard to use.
I think it is a good idea to split the user manual content into modules inside
the user manual component, in fact I considered doing it. The comment 2 ago
indicates that splitting into a separate module was planned, but the previous
comment and changes appear to split into a separate component.
The comments on the commits don't appear to relate to the changes: they claim
they are introducing a new module but are introducing a new component.
I agree the FAQ would benefit from a quick lookup.
The PRs are very difficult to understand: they should be squashed into a
minimal number of commits.
> 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
>
> Time Spent: 10m
> Remaining Estimate: 0h
>
> 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)
