dapr / dapr/proposals

[Discussion] Should Beta be an API lifecycle stage?

Open
#13 2 comments 0 reactions 0 assignees View on GitHub
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.