Skip to content

chore: Evaluate @Beta tags#761

Merged
Jonas-Isr merged 11 commits intomainfrom
evaluate-beta-tags
Feb 27, 2026
Merged

chore: Evaluate @Beta tags#761
Jonas-Isr merged 11 commits intomainfrom
evaluate-beta-tags

Conversation

@Jonas-Isr
Copy link
Copy Markdown
Member

Context

As discussed, this PR challenges some of our current @Beta tags.

For the ones I did not add a specific comment, I thought the API is fairly established and major changes are unlikely. For all other cases I added some reasoning.

The @Beta tags on the ...Api and ...Client classes stay since they are more or less just wrappers around generated code.

The other @Beta tags I left in where either because they were on pretty new classes/API or because they were on internally used methods and classes.

@Jonas-Isr Jonas-Isr self-assigned this Feb 18, 2026
* href="https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.html">Jackson2ObjectMapperBuilder</a>
*/
@Nonnull
@Beta
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is already a class-level beta annotation

*/
@Beta
@Nonnull
public OpenAiClient withApiVersion(@Nonnull final String apiVersion) {
Copy link
Copy Markdown
Contributor

@newtork newtork Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(Minor)

While I like the API and implementation, I do wonder whether the Beta annotation was used to discourage the usage. If I recall correctly we actually did not want users to use that method - right? We could check back with PO. Maybe there is a productive use-case for that.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I recall correctly we actually did not want users to use that method - right?

I don't remember this. But maybe someone else?

Copy link
Copy Markdown
Member Author

@Jonas-Isr Jonas-Isr Feb 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I asked Junjie as well, he does not know of any use-case. So I will keep @Beta here to discourage usage.

@Jonas-Isr Jonas-Isr enabled auto-merge (squash) February 27, 2026 11:03
Copy link
Copy Markdown
Member

@rpanackal rpanackal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Jonas-Isr Jonas-Isr merged commit 4eb3a78 into main Feb 27, 2026
6 checks passed
@Jonas-Isr Jonas-Isr deleted the evaluate-beta-tags branch February 27, 2026 11:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants