mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
f0fbced1c5
* Move from `docs/` to `contributing-docs/` * Updated file names to better communicate their content * Consolidated content into fewer docs * Updated and/or deleted obsolete info PR Close #56141
24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
## Releasing APIs before they're fully stable
|
|
|
|
The Angular team may occasionally seek to release a feature or API without immediately
|
|
including this API in Angular's normal support and deprecation category. You can use
|
|
one of two labels on such APIs: Developer Preview and Experimental. APIs tagged this way
|
|
are not subject to Angular's breaking change and deprecation policy.
|
|
|
|
Use the sections below to decide whether a pre-stable tag makes sense.
|
|
|
|
### Developer Preview
|
|
|
|
Use "Developer Preview" when:
|
|
* The team has relatively high confidence the API will ship as stable.
|
|
* The team needs additional community feedback before fully committing to an exact API shape.
|
|
* The API may undergo only minor, superficial changes. This can include changes like renaming
|
|
or reordering parameters, but should not include significant conceptual or structural changes.
|
|
|
|
### Experimental
|
|
|
|
Use "Experimental" when:
|
|
* The team has low-to-medium confidence that the API should exist at all.
|
|
* The team needs additional community feedback before deciding to move forward with the API at all.
|
|
* The API may undergo significant conceptual or structural changes.
|
|
* The API relies on a not-yet-standardized platform feature.
|