You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@camel.apache.org by "Claus Ibsen (Jira)" <ji...@apache.org> on 2026/10/02 11:03:00 UTC

[jira] [Created] (CAMEL-25265) docs - language pages show their examples in Java, XML and YAML tabs

Claus Ibsen created CAMEL-25265:
-----------------------------------

             Summary: docs - language pages show their examples in Java, XML and YAML tabs
                 Key: CAMEL-25265
                 URL: https://issues.apache.org/jira/browse/CAMEL-25265
             Project: Camel
          Issue Type: Improvement
          Components: documentation
            Reporter: Claus Ibsen
             Fix For: 4.23.0


Many examples on the language documentation pages show a route in only one or two of the Java, XML and YAML DSLs, or are not grouped in [tabs]. Pages and gaps:
* jq: Java-only routes, including its header(), property(), constant() and variable() functions and the source option;
* jsonpath: split, writeAsString, unpack, the source option, suppressExceptions and allowSimple have no YAML;
* xpath and xquery: Java-only routes, namespaces, and a tab group without Java;
* groovy and datasonnet: tab groups without YAML;
* xtokenize and constant: tab groups without Java;
* java: Java-only routes;
* quickjs, spel, wasm, jactl and python3: Java-only routes, some as RouteBuilder classes;
* typesafe-ai: the Java, XML and YAML blocks exist but are not in [tabs];
* bean and hl7terser: routes that have a YAML form.

The YAML examples are what camel_catalog_sample serves to AI agents, and the build validates them. A language whose examples are Java only gives an agent nothing to copy (jq today).

Java API code with no DSL equivalent, legacy Spring <beans> XML, and the semantic language (part of the DSL extensions design, CAMEL-25259) are left as they are.

_Claude Code on behalf of davsclaus_



--
This message was sent by Atlassian Jira
(v8.20.10#820010)