Claus Ibsen created CAMEL-24773:
-----------------------------------
Summary: docs - the remaining example kinds: Camel 1.x XML
namespace, Camel 2 XML elements, malformed XML fragments, wrong Java imports,
and user-manual YAML
Key: CAMEL-24773
URL: https://issues.apache.org/jira/browse/CAMEL-24773
Project: Camel
Issue Type: Task
Components: documentation
Reporter: Claus Ibsen
Assignee: Claus Ibsen
Follow-up to CAMEL-24710 (YAML route examples) and CAMEL-24770 (Java, XML and
properties examples). A census of all 10,563 {{[source]}} blocks of the source
{{.adoc}} pages, measured on 2026-09-16 on top of PR 26508, with checks the
earlier passes did not run: the XML namespace, XSD validation of
{{<camelContext>}} and of the fragments not rooted at {{<route>}} (CAMEL-24770
parsed only the {{<route>}} fragments), resolution of {{import
org.apache.camel.*}} lines against the reactor, the {{org.apache.camel}}
artifactIds of the {{<dependency>}} blocks, the YAML route blocks of the user
manual (the CAMEL-24693 guards walk the catalog pages only), and the {{camel}}
CLI commands and options of the bash blocks (all 533 invocations and 360
options are right, nothing to fix there). Each item was verified against the
model or component code.*XML - Camel 1.x namespace* (11 blocks):
{{xmlns="http://activemq.apache.org/camel/schema/spring"}} in cxf-transport
(2), xpath-language, xslt, xslt-saxon, xquery-component, xquery-language, ref,
delay-interceptor, tracer (2). Spring XML fails on it; xml-io ignores it, which
is why nothing caught it.*XML - Camel 2 elements and attributes that Spring XML
rejects** {{<camelContext><properties>}} → {{<globalOptions>}}:
http-component:433, log-eip:398* {{<onCompletion executorServiceRef>}} →
{{executorService}}: oncompletion:360* {{<avro instanceClass>}} →
{{instanceClassName}}: avro-dataformat:110* {{<soap namespacePrefixRef>}} →
{{namespacePrefix}}: jaxb-dataformat:215* {{<yaml><typeFilter value= type=/>}}
child elements → the {{typeFilter}} attribute (comma-separated):
snakeYaml-dataformat:106* {{<rest desription=>}} typo: poll-eip:164*
{{<restConfiguration bindingMode="true">}}: rest-dsl-openapi:450*
{{<intercept><onWhen>}} with {{<to>}} and {{<stop>}} nested inside {{onWhen}};
the outputs belong under {{<intercept>}}: intercept:259*XML - malformed
fragments** seda-component:92 {{<from>seda:...&size=100</from>}}: text content
and an unescaped {{&}}* intercept:387 {{<interceptFrom>}} closed by
{{</intercept>}}; properties-component:106 {{<propertyPlaceholder>}} never
closed; java-xml-io-dsl:196 {{<properties>}} closed by {{</constructors>}}*
simple-operators:360 {{<from uri="seda:orders">}} wrapping the route body*
simple-advanced:617 {{${replace(" , ∅)}}}: {{∅}} is not an XML
entity and {{"}} is decoded before Simple sees it, both need {{&}}*
rest-dsl-openapi:162 a {{// do something here}} comment inside {{<route>}}*XML
- Spring XSD order and required attributes* (xml-io accepts, Spring XML
validation fails)* exception-advanced:186 {{<redeliveryPolicy>}} before
{{<onWhen>}}; exception-advanced:282 {{<redeliveryPolicy>}} before
{{<exception>}}* jaxb-dataformat:244 and 268 {{<jaxb>}} without the required
{{contextPath}}* threading-model:177 {{<threadPool>}} without the required
{{threadName}}* rest-dsl-validation:280 {{<param name="id"/>}} without
{{type}}* route-template-bean-binding:333 {{<templateBean
scriptLanguage="groovy">}} without {{type}}: the model marks {{type}} required,
which looks over-strict for a scripted bean; check the model rather than the
page*Java** exchange-pooling:40 {{context.adapt(ExtendedCamelContext.class)}}:
removed in 4.0, now {{context.getCamelContextExtension()}}; the prose says "in
Camel 3.x"* keyValueRepository-eip: 7 imports with the wrong package (caffeine,
ehcache and jcache are under {{.processor}}; cassandra, jpa, kafka and jdbc are
{{org.apache.camel.processor.keyvalue.*}})*
langchain4j-spring-boot-integration:231 {{LangChain4jRagAggregatorStrategy}} is
in {{...chat.rag}}*Maven** aws2-redshift-data:155
{{<artifactId>camel-redshift-data</artifactId>}} → {{camel-aws2-redshift}}*YAML
(user manual, not covered by the guards)** camel-4x-upgrade-guide-4_23:2054 {{-
route: templateParameters:}} is {{- routeTemplate:}} with {{parameters:}}* the
saga "after" example of the 4_18 and 4_19 upgrade guides has {{key:
myOptionKey2}} directly on {{saga}}; the options are a list under
{{option:}}The guards for these checks are a separate ticket._Claude Code on
behalf of davsclaus_
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
