[Discussion] Should Beta be an API lifecycle stage?
- Dominant language
- No language data
- Stars
- 17
- Forks
- 39
- PR merge metrics
- No merged PRs in 30d
Description
Should Beta be an API lifecycle stage?
Currently as per https://github.com/dapr/proposals/blob/main/guides/api-design.md#api-lifecycle-expectations, Beta is a lifecycle stage for Dapr APIs.
The main advantages that I see here are that there are multiple different requirements that are needed to be completed to move an API from Alpha to Stable.
Beta is a stage that is in between Alpha and Stable and gives a guarantee to the users that the API will not be removed and will be worked on to make it stable. `If an API moves into Beta, the intention is that it will continue on to become stable and not be removed`
But there are some open questions as well.
- How will a Beta API be implemented and surfaced to the user? (v1.0-beta1 ? similar to v1.0-alpha1 in HTTP and in gRPC with a Beta suffix?)
- Does moving from Beta to Stable require a breaking change or will Beta API still continue to exist for a couple of releases after Stable API is available?
cc @dapr/maintainers-dapr @dapr/maintainers-components-contrib thoughts?
Contributor guide
No contributing guide indexed for this repository
Research direction
Start by reading guides/api-design.md at the API lifecycle expectations section. Review the two open questions about how Beta is surfaced in HTTP and gRPC and how the Beta-to-Stable transition is handled. Done means the project has a decided lifecycle policy and the guide reflects that decision.
Written by the indexing model from the issue text.
Assessment
- Domain
- api, backend-api-design
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100