Elgato_dark/angular
1
0
Fork 0
mirror of https://github.com/angular/angular synced 2026-05-24 09:28:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
angular/contributing-docs/dev_preview_and_experimental.md
Jeremy Elbourn f0fbced1c5 docs: update and reorganize contributor docs (#56141) 
* 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
2024-06-11 08:20:59 -07:00

1.2 KiB
Raw Blame History

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.