Skip to content

Conversation

brophdawg11
Copy link
Contributor

@brophdawg11 brophdawg11 commented Aug 21, 2025

Adding an updated version of this diagram in the docs. This isn't linked to anywhere currently but will be once I update our docs for stable middleware.

flowchart TD;
A{"`Is this a <br/>breaking change?`"} -->|No| D("`🚀 Ship **unstable_** API`");
D --> D*["Beta testing"]
D* -->E("`🚀 Remove **unstable_** prefix`")

A -->|Yes| F{"Can the developer opt-in at the call-site?"}
F -->|Yes| D

F -->|No| I("`🚀 Ship **unstable_** API behind **future.unstable_** flag`");
I --> I*[Beta testing]
I* --> J("`🚀 Remove **unstable_** API prefix and rename flag to **future.vN_**`")
J -->|Before next major version| K("🚀 Ship deprecation warnings in current version for users who have not adopted the flag")

K -->|Eventually| L("Ship next version with future flag behavior as the default behavior")
Loading

Live Preview

This was the old version of this doc in case we ever need it

@brophdawg11 brophdawg11 merged commit 19aa959 into main Aug 21, 2025
1 check passed
@brophdawg11 brophdawg11 deleted the brophdawg11/feature-flowchart branch August 21, 2025 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant