Skip to content

chore: Remove @Beta annotations#875

Open
CharlesDuboisSAP wants to merge 4 commits into
mainfrom
remove-beta
Open

chore: Remove @Beta annotations#875
CharlesDuboisSAP wants to merge 4 commits into
mainfrom
remove-beta

Conversation

@CharlesDuboisSAP
Copy link
Copy Markdown
Contributor

@CharlesDuboisSAP CharlesDuboisSAP commented May 27, 2026

Context

Previous PR for context:

@CharlesDuboisSAP CharlesDuboisSAP self-assigned this May 27, 2026
@CharlesDuboisSAP CharlesDuboisSAP added the please-review Request to review a pull-request label May 27, 2026
@CharlesDuboisSAP CharlesDuboisSAP changed the title Remove beta chore: Remove @Beta annotations May 27, 2026
Comment on lines -26 to 27
@Beta
public class OrchestrationConfigClient extends OrchestrationConfigsApi {
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

(minor)

Keep this beta tag since it extends unstable (generated) code

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

We said generated code will not be annotated as Beta

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We said generated code will not be annotated as Beta

Yes, but this is not generated code and also for users does not look like generated code. So the instability of the API might not be obvious to users.

*
* @param chatCompletionRequests the list of chat completion requests to include in the batch
*/
@Beta
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

(Question)

What is the rational behind removing the tag on the class level but keeping it on this specific method?

* 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

Choose a reason for hiding this comment

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

(Question)

Why do you move the tag here?

Comment on lines -26 to 27
@Beta
public class OrchestrationConfigClient extends OrchestrationConfigsApi {
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We said generated code will not be annotated as Beta

Yes, but this is not generated code and also for users does not look like generated code. So the instability of the API might not be obvious to users.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

please-review Request to review a pull-request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants