davsclaus opened a new pull request, #28027:
URL: https://github.com/apache/camel/pull/28027

   Fifth part of CAMEL-25736: YAML examples for 47 cloud and SaaS components 
whose documentation had none. `camel_catalog_sample` reads its samples from the 
documentation, so it had nothing to give for them.
   
   The components:
   - Alibaba Cloud: eventbridge, fc, kms, mns, oss, ots, sls and sms.
   - AWS: cloudtrail, config, ddb, ddbstream, textract, transcribe, translate, 
bedrock-agent and bedrock-agent-runtime.
   - Google: bigquery, bigquery-sql, calendar, calendar-stream, drive, 
mail-stream, sheets and sheets-stream.
   - OpenStack: cinder, glance, keystone, neutron, nova and swift. Kubernetes: 
cronjob and custom-resources.
   - SaaS: twitter-directmessage, twitter-search, twitter-timeline, servicenow, 
twilio, jira, whatsapp, wordpress, workday, zendesk, stitch, clickup, cm-sms 
and chatscript.
   
   ## What
   
   - A Java example of a route gets a YAML tab next to it. SDK builders, 
processors and `ProducerTemplate` code stay Java-only.
   - A page without a route example gets a short example.
   - **These examples were not run:** they need cloud or SaaS accounts. Every 
option, enum value, header and API method name was checked against the 
component's JSON metadata and its code. Credentials are property placeholders.
   
   ## What the checks found in the pages
   
   - **aws2-translate:** the Java examples did not compile. They used 
`TranslateConstants` and `TranslateLanguageEnum`; the classes are 
`Translate2Constants` and `Translate2LanguageEnum`.
   - **google-bigquery:** the endpoint URI had no project id; the syntax is 
projectId:datasetId:tableId.
   - **google-drive:** the link pointed to the Drive v2 reference; the 
component uses v3.
   - **google-sheets-stream:** a section about the `ValueInputOption` header 
was copied from the google-sheets page; the consumer has no such option.
   - **kubernetes-custom-resources:** the intro spoke of Node objects.
   - **twitter-timeline:** `retweetsofme` is not a timeline type, and `public` 
has no consumer or producer. The page now lists home, mentions, user and list.
   - **servicenow:** the Java example missed a parenthesis.
   
   The catalog copies of the 47 pages are updated with them.
   
   ## Checks
   
   - Every new example passes `camel_validate_source`, also as read back from 
the page.
   - On a full reactor build, the tests of camel-catalog (1101), 
camel-yaml-dsl-validator (240), camel-jbang-core (2511) and camel-jbang-mcp 
(503) pass, `CatalogDocExamplesTest` included.
   
   Problems outside the docs that the checks found (missing headers in the 
metadata, options labelled consumer-only that the producer uses, and others) 
are collected in the umbrella issue CAMEL-25740.
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)
   
   https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
   


-- 
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