Skip to content

Commit 9c9423f

Browse files
committed
doc: add experimental modules lifetime policy
Signed-off-by: Paolo Insogna <paolo@cowtech.it>
1 parent ed05549 commit 9c9423f

File tree

2 files changed

+13
-0
lines changed

2 files changed

+13
-0
lines changed

doc/api/documentation.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,14 @@ The stability indexes are as follows:
4747
>
4848
> Experimental features leave the experimental status typically either by
4949
> graduating to stable, or are removed without a deprecation cycle.
50+
>
51+
> Collaborators who introduce experimental modules are expected to take
52+
> ownership and drive each experiment in a timely manner to a clear outcome:
53+
> either promotion to stable or removal.
54+
>
55+
> If an experimental feature has reached mainstream adoption such that breaking
56+
> changes are not realistically possible without ecosystem breakage, it should
57+
> be considered stable and promoted as soon as possible.
5058
5159
<!-- separator -->
5260

doc/contributing/collaborator-guide.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -462,6 +462,11 @@ For pull requests introducing new core modules:
462462
* Land only after sign-off from at least two TSC voting members.
463463
* Land with a [Stability Index][] of Experimental. The module must remain
464464
Experimental until a semver-major release.
465+
* Introducing an Experimental feature means taking ownership of the experiment
466+
and committing to a clear outcome: either promoting it to stable or removing
467+
it in a timely manner. Because experimental features can be vulnerable to
468+
security issues, the author is also expected to help assess and patch
469+
vulnerabilities.
465470

466471
### Introducing new APIs on the global scope
467472

0 commit comments

Comments
 (0)