Skip to content

doc: add experimental modules lifetime policy#62753

Merged
nodejs-github-bot merged 2 commits intonodejs:mainfrom
ShogunPanda:experimental-review
Apr 18, 2026
Merged

doc: add experimental modules lifetime policy#62753
nodejs-github-bot merged 2 commits intonodejs:mainfrom
ShogunPanda:experimental-review

Conversation

@ShogunPanda
Copy link
Copy Markdown
Contributor

@ShogunPanda ShogunPanda commented Apr 15, 2026

This PR documents a new lifetime policy for experimental modules by adding guidance to the API documentation and the collaborator guide. It clarifies maintenance expectations and helps contributors apply a consistent standard when introducing or managing experimental modules.

@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Apr 15, 2026
Comment thread doc/contributing/collaborator-guide.md Outdated
Comment thread doc/contributing/releases.md Outdated
@ShogunPanda
Copy link
Copy Markdown
Contributor Author

@RafaelGSS After speaking to the good @marco-ippolito I realized (read as: he made me realize I was totally mistaken 😂) that experimental stability changes are not semver-major but minor. This means that I can eventually write a regular monthly (quarterly or whatever) automation to open issue on the project but they are totally unbound from the release cycle.

I'll update this proposal shortly.

@ShogunPanda ShogunPanda force-pushed the experimental-review branch from a6ed61f to 9c9423f Compare April 15, 2026 13:15
@ShogunPanda ShogunPanda changed the title doc: add experimental modules review policy doc: add experimental modules lifetime policy Apr 15, 2026
@ShogunPanda
Copy link
Copy Markdown
Contributor Author

@RafaelGSS Updated. WDYT?

@ShogunPanda ShogunPanda requested a review from RafaelGSS April 15, 2026 13:18
Comment thread doc/api/documentation.md Outdated
Comment thread doc/api/documentation.md Outdated
Comment thread doc/api/documentation.md Outdated
Signed-off-by: Paolo Insogna <paolo@cowtech.it>
@ShogunPanda ShogunPanda force-pushed the experimental-review branch from f2e3be2 to 36a27fe Compare April 18, 2026 08:01
Signed-off-by: Paolo Insogna <paolo@cowtech.it>
@ShogunPanda ShogunPanda added commit-queue Add this label to land a pull request using GitHub Actions. commit-queue-squash Add this label to instruct the Commit Queue to squash all the PR commits into the first one. labels Apr 18, 2026
@nodejs-github-bot nodejs-github-bot removed the commit-queue Add this label to land a pull request using GitHub Actions. label Apr 18, 2026
@nodejs-github-bot nodejs-github-bot merged commit 0fe3949 into nodejs:main Apr 18, 2026
23 checks passed
@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Landed in 0fe3949

@ShogunPanda ShogunPanda deleted the experimental-review branch April 18, 2026 10:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

commit-queue-squash Add this label to instruct the Commit Queue to squash all the PR commits into the first one. doc Issues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants