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

   # Description
   
   Continues [CAMEL-23535](https://issues.apache.org/jira/browse/CAMEL-23535). 
Batches 1-15 were merged in #24060 (management, threading, observability SPIs).
   
   This PR covers batches 16-20: **26 files** in `core/camel-api` received 
enhanced class-level Javadoc. The changes are documentation-only; no method 
signatures, annotations, or production code were altered.
   
   **Batch 16 — REST SPIs** (`spi/`)
   `RestConfiguration`, `RestProducerFactory`, `RestRegistry`, 
`RestBindingJaxbDataFormatFactory`, `RestApiConsumerFactory`
   
   **Batch 17 — CLI and model-dumper SPIs** (`spi/`)
   `CliConnector`, `CliConnectorFactory`, `ModelToXMLDumper`, 
`ModelToYAMLDumper`, `ModelToJavaDumper`, `RouteTopologyDumper`
   
   **Batch 18 — Properties, language, and resolver SPIs** (`spi/`)
   `PropertiesComponent`, `PropertiesFunction`, `Language`, `LanguageResolver`, 
`DataFormatResolver`, `RoutesBuilderLoader`, `HeadersMapFactory`
   
   **Batch 19 — Exchange processing SPIs** (`spi/`)
   `LifecycleStrategy`, `UnitOfWork`, `UnitOfWorkFactory`, `InflightRepository`
   
   **Batch 20 — Root-package utility and exception types** (`org.apache.camel`)
   `NoSuchBeanException`, `StaticService`, `SSLContextParametersAware`, 
`NoFactoryAvailableException`
   
   Each file received:
   - A clear opening sentence naming its role in the Camel system
   - An architecture paragraph with `{@link}` references and explanation of 
callers/lifecycle
   - At least one user-manual `<a href>` link where a matching page exists
   - `@see` tags for closely related sibling types
   - Preserved `@since` tags
   
   A post-write Opus code review surfaced 9 factual errors (wrong module names, 
fabricated alternative implementations, non-existent URLs); all were corrected 
before this PR was opened.
   
   # Target
   
   - [x] I checked that the commit is targeting the correct branch (Camel 4 
uses the `main` branch)
   
   # Tracking
   
   - [x] If this is a large change, bug fix, or code improvement, I checked 
there is a [JIRA issue](https://issues.apache.org/jira/browse/CAMEL-23535) 
filed for the change (usually before you start working on it).
   
   # Apache Camel coding standards and style
   
   - [x] I checked that each commit in the pull request has a meaningful 
subject line and body.
   - [x] I have run `mvn clean install -DskipTests` locally from root folder 
and I have committed all auto-generated changes.
   
   _Claude Code on behalf of Adriano Machado_


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