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.


Reply via email to