Azure / azure-sdk-tools

Tools repository leveraged by the Azure SDK team.
MIT License
111 stars 176 forks source link

The service/feature team must explicitly agree no breaking change to GAed libraries #6452

Open josefree opened 1 year ago

josefree commented 1 year ago

The following request is initiated from management-plane, but I think this can be applied to data plane SDK release too.

The service/feature team must explicitly agree no breaking change to GAed libraries. “Explicitly” means if we can keep a recording of their commitment when they approaching first GA? And we shall let the team know the consequence – If you introduce any breaking change to GAed libraries, you may have to work on the breaking changes in the future SDK releases manually. We truly hope this can reduce breaking change number and frequency, which bothers us a lot, refer to the breaking change analysis attached below

image

maririos commented 1 year ago

And we shall let the team know the consequence

Do you have this documentation somewhere the Release Planner could link to?

maririos commented 1 year ago

@josefree we need the documentation to be updated first before our apps can take the dependency. Please make the respective changes to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release

maririos commented 1 year ago

FYI @ladonnaq to help drive the requirement

maririos commented 10 months ago

@josefree

@josefree we need the documentation to be updated first before our apps can take the dependency. Please make the respective changes to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release

maririos commented 3 weeks ago

@ladonnaq and @josefree is this still something that is needed?