(camel-quarkus) branch main updated: Remove xref for the removed wasm language (#9345)

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git


The following commit(s) were added to refs/heads/main by this push:
     new 6aa87247f7c Remove xref for the removed wasm language (#9345)
6aa87247f7c is described below

commit 6aa87247f7c38007e5da9b3552cc107c9ee68475
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Sun Oct 18 10:30:09 2026 +0200

    Remove xref for the removed wasm language (#9345)
    
    Camel main removed the wasm language (CAMEL-25677), so the Wasm extension
    page links to a page that no longer exists in the next Camel docs, and the
    camel-website Antora build fails on it.
    
    The camel-wasm component and language share the name wasm, so a link
    override keyed by name alone would also remove the component link, which
    is still valid. Let an override key be qualified with the model kind
    (wasm-language) to target only the language.
    
    Co-authored-by: Claude Opus 5.5 (1M context) <no...@anthropic.com>
---
 .../ROOT/pages/contributor-guide/extension-documentation.adoc       | 2 +-
 docs/modules/ROOT/pages/reference/extensions/wasm.adoc              | 4 ++--
 extensions/pom.xml                                                  | 4 ++++
 .../org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java  | 6 ++++--
 4 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc b/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
index feff096e7c4..30c3bbd3b86 100644
--- a/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
+++ b/docs/modules/ROOT/pages/contributor-guide/extension-documentation.adoc
@@ -77,7 +77,7 @@ To override parts of the xref link, the following `update-extension-doc-page` co
 </plugin>
 ----
 
-<1> The original name of the Camel component.
+<1> The original name of the Camel component. When an extension contains several models with the same name (E.g. the `wasm` component and the `wasm` language), qualify the name with its kind (E.g. `wasm-language`) to override the link of only that model.
 <2> The overridden name of the component in the generated xref link.
 <3> The overridden component kind in the generated xref link (`component`, `dataformat`, `language`, `other`).
 <4> The overridden component generated xref link prefix. Useful for rare circumstances where the component requires you to link to an unconventional part of the Camel documentation (E.g. link `manual`).
diff --git a/docs/modules/ROOT/pages/reference/extensions/wasm.adoc b/docs/modules/ROOT/pages/reference/extensions/wasm.adoc
index c5b2b65421a..c6d913c2e3b 100644
--- a/docs/modules/ROOT/pages/reference/extensions/wasm.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/wasm.adoc
@@ -23,9 +23,9 @@ Invoke Wasm functions.
 == What's inside
 
 * xref:{cq-camel-components}::wasm-component.adoc[Wasm component], URI syntax: `wasm:functionName`
-* xref:{cq-camel-components}:languages:wasm-language.adoc[Wasm language]
+* Wasm
+
 
-Please refer to the above links for usage and configuration details.
 
 [id="extensions-wasm-maven-coordinates"]
 == Maven coordinates
diff --git a/extensions/pom.xml b/extensions/pom.xml
index de2071799aa..1b0d97dd644 100644
--- a/extensions/pom.xml
+++ b/extensions/pom.xml
@@ -365,6 +365,10 @@
                                             <name>camel-github</name>
                                             <xrefPrefix>remove</xrefPrefix>
                                         </github>
+                                        <!-- TODO: Remove for Camel > 4.23.0 -->
+                                        <wasm-language>
+                                            <xrefPrefix>remove</xrefPrefix>
+                                        </wasm-language>
                                     </componentLinkOverrides>
 
                                 </configuration>
diff --git a/tooling/maven-plugin/src/main/java/org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java b/tooling/maven-plugin/src/main/java/org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java
index 4629a04fc64..075b5186d1e 100644
--- a/tooling/maven-plugin/src/main/java/org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java
+++ b/tooling/maven-plugin/src/main/java/org/apache/camel/quarkus/maven/UpdateExtensionDocPageMojo.java
@@ -239,8 +239,10 @@ public class UpdateExtensionDocPageMojo extends AbstractDocGeneratorMojo {
                 String name = model.getName();
                 String xrefPrefix = "xref:{cq-camel-components}:" + (!"component".equals(kind) ? kind + "s:" : ":");
 
-                if (componentLinkOverrides.containsKey(name)) {
-                    ComponentLinkOverride override = componentLinkOverrides.get(name);
+                // A kind qualified key (e.g. wasm-language) targets one model when several share the same name
+                String overrideKey = componentLinkOverrides.containsKey(name + "-" + kind) ? name + "-" + kind : name;
+                if (componentLinkOverrides.containsKey(overrideKey)) {
+                    ComponentLinkOverride override = componentLinkOverrides.get(overrideKey);
                     if (override != null) {
                         if (override.getName() != null) {
                             name = override.getName();