davsclaus opened a new pull request, #27233: URL: https://github.com/apache/camel/pull/27233
`camel_catalog_sample rest` returned only the path-based examples of `rest-dsl.adoc`. The contract-first form (`rest: openApi: specification:`) on `rest-dsl-openapi.adoc` was validated by the build but never sampled, so a model building an OpenAPI server from a contract was shown the other style. - `rest-dsl-openapi.adoc` is an entry page of `rest` in the `generate-doc-samples` configuration, so its `- rest:` examples become samples too. - `GenerateDocSamplesMojo` takes the samples of a name from each page in turn, so the default two (`DEFAULT_LIMIT = 2`) show both forms. The only other name with samples from several pages is `doTry`, which now shows `try-catch-finally.adoc` second. - The `rest-openapi` component page gets a short contract-first section (Java, XML, YAML), so `camel_catalog_sample rest-openapi` shows it after the consumer endpoint example. Tests: `GenerateDocSamplesMojoTest` (interleaving), `CatalogSamplesTest` (`rest` default two, `rest-openapi` component). `mvn verify` green in camel-yaml-dsl-validator-maven-plugin (10 tests) and camel-jbang-core (1379 tests). 🤖 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]
