Skip to content

[draft] new versioning#43766

Closed
xitzhang wants to merge 16 commits into
mainfrom
xitzhang/v1versioning
Closed

[draft] new versioning#43766
xitzhang wants to merge 16 commits into
mainfrom
xitzhang/v1versioning

Conversation

@xitzhang

@xitzhang xitzhang commented Jun 4, 2026

Copy link
Copy Markdown
Member

Choose a PR Template

Switch to "Preview" on this description then select one of the choices below.

Click here to open a PR for a Data Plane API.

Click here to open a PR for a Control Plane (ARM) API.

Click here to open a PR for only SDK configuration.

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

Next Steps to Merge

Next steps that must be taken to merge this PR:
  • ❌ This PR targets either the main branch of the public specs repo or the RPSaaSMaster branch of the private specs repo. These branches are not intended for iterative development. Therefore, you must acknowledge you understand that after this PR is merged, the APIs are considered shipped to Azure customers. Any further attempts at in-place modifications to the APIs will be subject to Azure's versioning and breaking change policies. Additionally, for control plane APIs, you must acknowledge that you are following all the best practices documented by ARM at aka.ms/armapibestpractices. If you do intend to release the APIs to your customers by merging this PR, add the PublishToCustomers label to your PR in acknowledgement of the above. Otherwise, retarget this PR onto a feature branch, i.e. with prefix release- (see aka.ms/azsdk/api-versions#release--branches).
  • ❌ Your PR requires an API stewardship board review as it introduces a new API version (label: new-api-version). Schedule the review by following aka.ms/azsdk/onboarding/restapischedule.
  • ❌ This PR has at least one breaking change (label: BreakingChangeReviewRequired).
    To unblock this PR, follow the process at aka.ms/brch.
  • ❌ The required check named TypeSpec Validation has failed. Refer to the check in the PR's 'Checks' tab for details on how to fix it and consult the aka.ms/ci-fix guide


Comment generated by summarize-checks workflow run.

@github-actions github-actions Bot added data-plane new-api-version TypeSpec Authored with TypeSpec BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required labels Jun 4, 2026
@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

API Change Check

APIView identified API level changes in this PR and created the following API reviews

Language API Review for Package
Swagger Azure.AI.Agents-VoiceLive

Comment generated by After APIView workflow run.

@github-actions github-actions Bot removed the BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required label Jun 4, 2026
Xiting Zhang added 9 commits June 4, 2026 15:24
Add docs/versioning.md describing the label-based (v1) versioning model, CONTRIBUTING.md with authoring rules for GA/preview/breaking changes, and a Contributing pointer in readme.md.
Fence the preview-only 'smart_end_of_turn_detection' EouDetection.model value out of v1 via a stacked @typeChangedFrom(Versions.v1, ...), so the regenerated stable/v1 swagger matches the last dated GA (2026-04-10).
…string at v1

v1 declares EouDetection.model and AudioInputTranscriptionOptions.model as plain string (no enum), while 2026-04-10 / 2026-06-01-preview retain their open enums via @typeChangedFrom. Frozen versions stay byte-identical; only v1 surface changes.
@github-actions github-actions Bot added the BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required label Jun 18, 2026
Xiting Zhang added 2 commits June 18, 2026 16:50
…string at v1

v1 declares EouDetection.model and AudioInputTranscriptionOptions.model as plain string (no enum), while 2026-04-10 / 2026-06-01-preview retain their open enums via @typeChangedFrom. Frozen versions stay byte-identical; only v1 surface changes.
The merge commit da54c01 inadvertently baked a stale working-tree deletion of .github/arm-leases/postgresql/Microsoft.DBforPostgreSQL/PostgreSql/lease.yaml into history. Restore the file (originally added in d09dc78) at its exact original path casing.
@xitzhang xitzhang closed this Jun 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required data-plane new-api-version TypeSpec Authored with TypeSpec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant