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.