Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions doc/api/documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,14 @@ The stability indexes are as follows:
>
> Experimental features leave the experimental status typically either by
> graduating to stable, or are removed without a deprecation cycle.
>
> Collaborators who introduce experimental modules are expected to take
> ownership and drive each experiment in a timely manner to a clear outcome:
> either promotion to stable or removal.
>
> If an experimental feature has reached mainstream adoption such that breaking
Comment thread
marco-ippolito marked this conversation as resolved.
> changes are not realistically possible without ecosystem breakage, it should
> be considered stable and either be promoted or be removed after a deprecation cycle.

<!-- separator -->

Expand Down
5 changes: 5 additions & 0 deletions doc/contributing/collaborator-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -462,6 +462,11 @@ For pull requests introducing new core modules:
* Land only after sign-off from at least two TSC voting members.
* Land with a [Stability Index][] of Experimental. The module must remain
Experimental until a semver-major release.
* Introducing an Experimental feature means taking ownership of the experiment
and committing to a clear outcome: either promoting it to stable or removing
it in a timely manner. Because experimental features can be vulnerable to
security issues, the author is also expected to help assess and patch
vulnerabilities.

### Introducing new APIs on the global scope

Expand Down
Loading