Upgrade camel to 4.16.0

[JiriOndrusek]

Upgrade to Camel 4.16.0

[JiriOndrusek]

There is a missing pqc-dataformat.adoc. Our update-extension-doc-page is expecting the pqc-dataformat.adoc to exist and generates a xref to this file. -> camel-website validation fails
I put a workaround, so that link is not generated. The workaround should be removed as soon as the doc is added. See //see #7942

[aldettinger]

@JiriOndrusek https://issues.apache.org/jira/browse/CAMEL-22586 seems fixed in 4.16.0, so the workaround is still needed ? Or there is a follow up issue maybe ?

[JiriOndrusek]

@aldettinger I linked bad ticket in the CQ.
Dataformat exists, but the doc page is missing https://issues.apache.org/jira/browse/CAMEL-22652

[JiriOndrusek]

I see that Andrea already fixed that , so perhaps I can remove the workaround. Let me try it.

[aldettinger]

It seems fixed in 4.17, so the workaround would probably need to stay.

[JiriOndrusek]

Workaround is removed, lets wait for CI to confirm it.

[JiriOndrusek]

I'll remove the workaround in camel-main, it is still required in main

[jamesnetherton]

I'll remove the workaround in camel-main, it is still required in main

Our antora.yml points at the next docs version. So if the problem is fixed on the Camel core main branch, it should work ok.

In any case, there's a alternative method of controlling the doc component links:

https://camel.apache.org/camel-quarkus/next/contributor-guide/extension-documentation.html#_overriding_generated_component_links

[JiriOndrusek]

Member

The override mechanism is handy. I set both links (for dataformat and component) to xref camel component.

The other option is to remove xrefs at all

[JiriOndrusek]

@jamesnetherton the overriding mechanism you mentioned works correctly, unfortunately there is no option to remove only xref to one kind. Let me explain.

• (1) Originally the xrefs are

* xref:{cq-camel-components}:dataformats:pqc-dataformat.adoc[PQC (Post-Quantum Cryptography) data format]
* xref:{cq-camel-components}::pqc-component.adoc[PQC Algorithms component], URI syntax: `pqc:label`

and the first one is not valid.

• (2) The overriding mechanism allows to remove both of them to

* PQC (Post-Quantum Cryptography)
* PQC Algorithms

• (3) The original workaround (which was inside the plugin itself) removed only the first xref, so the result was

* PQC (Post-Quantum Cryptography)
* xref:{cq-camel-components}::pqc-component.adoc[PQC Algorithms component], URI syntax: `pqc:label`

I think that both options are acceptable for now (both options - 2 & 3 - are workarounds)
I kept option (3) as it does not require altering the plugin.
WDYT?

[JiriOndrusek]

@jamesnetherton I kept the original workaround with the plugin.
And I think that we can merge this PR as soon as CI is green.