ammachado opened a new pull request, #23821: URL: https://github.com/apache/camel/pull/23821
# Description Batch 7 of [CAMEL-23535](https://issues.apache.org/jira/browse/CAMEL-23535): enhance class-level Javadoc across `core/camel-api` to help both human developers and AI systems understand each type's purpose, architecture role, and connections to the user manual. This batch covers the **type conversion and class resolution** subsystem, which is foundational: nearly every other SPI depends on these types. Files enhanced (11 total): **`org.apache.camel` (root package):** - `TypeConverter` - expanded with architecture context, conversion variant descriptions, and `{@link}` cross-references - `TypeConverterExists` - added policy context, user manual link, and `@see` tags - `TypeConverters` - added user manual link and clarified marker-interface purpose **`org.apache.camel.spi`:** - `TypeConverterRegistry` - expanded with startup discovery lifecycle, duplicate policy, and statistics documentation - `TypeConverterLoader` - added classpath discovery mechanism context - `BulkTypeConverters` - added user manual link and explained the build-phase code-generation optimization - `ClassResolver` - added platform-neutral rationale and optional vs. throwing variant distinction - `PackageScanClassResolver` - added scanning lifecycle, cache management, and global filter context - `PackageScanFilter` - added functional interface usage example and per-query vs. global filter distinction - `FactoryFinder` - added service-file convention explanation and `FactoryFinderResolver` relationship - `FactoryFinderResolver` - added bootstrap vs. runtime phase separation rationale All changes are Javadoc-only (no code or signature modifications). Formatting applied via `mvn formatter:format impsort:sort`. _Claude Code on behalf of Adriano Machado_ # 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) 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. -- 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]
