-
Notifications
You must be signed in to change notification settings - Fork 30.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
repl: update deprecation codes #33430
Conversation
I don't remember where our documentation says that we should use placeholders for deprecations, but can we change it? We forget to update it way too often and it seems possible to me to have a lint rule to validate the numbers in deprecations.md (no duplicate, sequential). |
Collaborators please 👍 to fast track this. |
@targos I agree that we should change that. To verify that we have unique codes, we should just add a test that verifies that the codes are unique in our markdown file. |
CI: https://ci.nodejs.org/job/node-test-pull-request/31374/ ✅ (all green besides a known CI issue that is unrelated) |
Refs: nodejs#33294 PR-URL: nodejs#33430 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Landed in a12a2d8 🎉 |
Adding the |
Sidenote: this was actually the intention originally but it never manifested for various reasons. The main difficulty here with deprecation codes is that we do not know when they are actually going to land in a release. What I would prefer is that we just assign the deprecation numbers in the release just like we handle the replaceme tags for versions. We would have to alter the testing strategy somewhat but that's fairly simple. |
@jasnell that would not work for backports. It should be possible to just lint for unique deprecation codes. That way we'll immediately know if a PR needs to update before landing. |
Well, I'd argue that we likely shouldn't be backporting deprecations but since we stopped requiring doc only deprecations to be major I guess that ship has sailed. Another approach would be to move away from numbered dep codes entirely and use simple labels. |
Refs: #33294
Checklist
make -j4 test
(UNIX), orvcbuild test
(Windows) passes