2024-04-12 00:25:37 +00:00
|
|
|
## 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.
|
|
|
|
|
|
2025-11-06 18:03:05 +00:00
|
|
|
Use the sections below to decide whether a pre-stable tag makes sense.
|
2024-04-12 00:25:37 +00:00
|
|
|
|
|
|
|
|
### Developer Preview
|
|
|
|
|
|
|
|
|
|
Use "Developer Preview" when:
|
2025-11-06 18:03:05 +00:00
|
|
|
|
|
|
|
|
- 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
|
2024-04-12 00:25:37 +00:00
|
|
|
or reordering parameters, but should not include significant conceptual or structural changes.
|
|
|
|
|
|
|
|
|
|
### Experimental
|
|
|
|
|
|
|
|
|
|
Use "Experimental" when:
|
2025-11-06 18:03:05 +00:00
|
|
|
|
|
|
|
|
- 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.
|
