Hi David & Cameleers,
as far as I’m aware, all sub-projects lag behind the latest Camel version. I
don’t know if that’s a problem, they usually are not very far behind.
For the documentation and Camel Quarkus in particular, the past experience was
that pointing to the latest Camel version often led to broken links so not
changing the version led to greater stability of the website.
I do think that documentation should be cross linked against the correct
versions, i.e. the ones they depend on in the code and that version should be
prominently displayed in the documentation.
zoran
--
Sent from mobile
> On 16. Sep 2021, at 22:10, David Jencks <david.a.jen...@gmail.com> wrote:
>
> While fixing the broken camel-quarkus partial website build I noticed a
> couple of things I don’t understand.
>
> 1. camel-quarkus latest seems to use camel 3.11.x, at least the docs do. I
> think that, if this is really correct, the camel-quarkus index page should
> prominently say that you aren’t getting the cutting-edge latest camel in
> camel-quarkus, but something slightly older. Naively, I expected
> camel-quarkus versions to track camel versions. Indicating the relationship
> between versions would certainly help me.
>
> 2. eips are now versioned with components, but at least some links from
> components to eips use {eip-vc} in
> xref:{eip-vc}:eips:polling-consumer.adoc[Polling Consumer]
> which points to the latest eips. If camel-quarkus really intentionally
> depends on camel 3.11.x then it should be possible to build the partial
> website with only the 3.11.x versions, but I get lots of errors like
>
> [ERROR] [12:44:05.727] ERROR (asciidoctor): target of xref not found:
> latest@components:eips:polling-consumer.adoc
> [ERROR] file: docs/components/modules/ROOT/pages/beanstalk-component.adoc
> [ERROR] source: https://github.com/apache/camel.git (refname:
> camel-3.11.x, start path: docs/components)
>
> I think there are 22 such usages, involving all links in the `components`
> component to eips.
>
> If we agree this is a problem I’ll prepare some PRs for the affected branches
> (presumably at least main and 3.11.x)
>
>
> David Jencks
>
> side note: The camel-quarkus index page (both latest and 2.0.0) says
> Camel Quarkus also takes advantage of the many performance improvements made
> in Camel 3, which results in a lower memory footprint, less reliance on
> reflection (which is good for native application support) and faster startup
> times.
> I’m bewildered by this, and want to know “compared with what?”. I also think
> it would be nice if there was an explanation of what is different between the
> latest and 2.0.0 versions of camel-quarkus, right on the index page.
>
>
