gnodet-bot commented on code in PR #26448:
URL: https://github.com/apache/camel/pull/26448#discussion_r4011794050


##########
components/camel-aws/camel-aws2-s3-vectors/src/main/docs/aws2-s3-vectors-component.adoc:
##########
@@ -61,6 +61,10 @@ The consumer polls for vectors using similarity search. It 
tracks processed vect
 
 == Examples
 
+The vector in the message body is a `List` of numbers, a `float[]` or a 
`double[]`.
+The YAML DSL has no way to write such a list as a constant, so the YAML 
examples build it with a Groovy expression
+and need `camel-groovy` on the classpath.
+

Review Comment:
   💬 **Nit:** The phrase "has no way to write such a list as a constant" is 
slightly imprecise. YAML can express a typed list under `constant:` (that was 
actually the approach before #26397), but it fails *schema/catalog validation*. 
The real constraint is a validation one, not a DSL expressiveness one.
   
   Suggested rephrasing that's both accurate and user-friendly:
   
   ```suggestion
   The vector in the message body is a `List` of numbers, a `float[]` or a 
`double[]`.
   The YAML DSL schema does not accept a numeric list under `constant:`, so the 
YAML examples build it with a Groovy expression
   and need `camel-groovy` on the classpath.
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to