You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by "gnodet (via GitHub)" <gi...@apache.org> on 2026/05/13 14:02:41 UTC

[PR] Add @since Javadoc tags to camel-api public types and methods [camel]

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

   ## Summary
   
   - Add 317 `@since` Javadoc tags to `core/camel-api` tracking when public API elements were introduced (Camel 3.0 through 4.21)
   - 266 class-level tags on types (interfaces, classes, enums, annotations) introduced in 3.0+, covering all subpackages (`health/`, `cluster/`, `console/`, `vault/`, `resume/`, `clock/`, `spi/`, etc.)
   - 51 method-level tags on methods added to pre-existing interfaces (`Exchange`, `CamelContext`, `Message`)
   - Update `AGENTS.md` with convention requiring `@since` tags on all new public API additions going forward
   
   Version provenance was determined using `git log --diff-filter=A` and `git tag --contains` to map each file/method to the release that first included it. Pre-3.0 files (moved during the CAMEL-13040 module reorganization) were excluded.
   
   ## Test plan
   
   - [x] `mvn install -B -pl core/camel-api -DskipTests` passes
   - [x] `mvn formatter:format impsort:sort -B -pl core/camel-api` produces no changes
   - [x] Spot-checked tags against git history for key files (Exchange, CamelContext, VariableAware, HealthCheck, vault configs)


-- 
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: commits-unsubscribe@camel.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] Add @since Javadoc tags to camel-api public types and methods [camel]

Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #23195:
URL: https://github.com/apache/camel/pull/23195#issuecomment-4442063810

   <!-- ci-tested-modules -->
   :test_tube: **CI tested the following changed modules:**
   
   - `core/camel-api`
   
   > :information_source: Dependent modules were not tested because the total number of affected modules exceeded the threshold (50). Use the `test-dependents` label to force testing all dependents.
   
   ---
   :gear: [View full build and test results](https://github.com/apache/camel/actions/runs/25804390247)


-- 
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: commits-unsubscribe@camel.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] Add @since Javadoc tags to camel-api public types and methods [camel]

Posted by "davsclaus (via GitHub)" <gi...@apache.org>.
davsclaus commented on PR #23195:
URL: https://github.com/apache/camel/pull/23195#issuecomment-4442778094

   there are merge conflicts


-- 
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: commits-unsubscribe@camel.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] Add @since Javadoc tags to camel-api public types and methods [camel]

Posted by "gnodet (via GitHub)" <gi...@apache.org>.
gnodet merged PR #23195:
URL: https://github.com/apache/camel/pull/23195


-- 
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: commits-unsubscribe@camel.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] Add @since Javadoc tags to camel-api public types and methods [camel]

Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #23195:
URL: https://github.com/apache/camel/pull/23195#issuecomment-4441785626

   :star2: Thank you for your contribution to the Apache Camel project! :star2:
     :robot: CI automation will test this PR automatically.
   
     :camel: Apache Camel Committers, please review the following items:
   
     * First-time contributors **require MANUAL approval** for the GitHub Actions to run
     * You can use the command `/component-test (camel-)component-name1 (camel-)component-name2..` to request a test from the test bot although they are normally detected and executed by CI.
     * You can label PRs using `skip-tests` and `test-dependents` to fine-tune the checks executed by this PR.
     * Build and test logs are available in the summary page. **Only** [Apache Camel committers](https://camel.apache.org/community/team/#committers) have access to the summary.
     
     :warning: Be careful when sharing logs. Review their contents before sharing them publicly.


-- 
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: commits-unsubscribe@camel.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org