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)

Reply via email to