diff options
author | Michael Dawson <mdawson@devrus.com> | 2022-01-06 23:51:38 +0300 |
---|---|---|
committer | Michael Dawson <mdawson@devrus.com> | 2022-02-04 23:54:21 +0300 |
commit | 6c0eb942b3d1851773fd31adf7b8cd2e6ccb405a (patch) | |
tree | df694ac88ca3bf54543a855e032c7f25d45c2da0 /doc | |
parent | 9e892e22e36c1186ff11cb050c33e5945c52c99d (diff) |
doc: feature management proposal
Refs: https://github.com/nodejs/node/discussions/40823
Refs: https://github.com/nodejs/node/issues/41113
Signed-off-by: Michael Dawson <mdawson@devrus.com>
PR-URL: https://github.com/nodejs/node/pull/41420
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Mary Marchini <oss@mmarchini.me>
Reviewed-By: Darshan Sen <raisinten@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/contributing/feature-request-management.md | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/doc/contributing/feature-request-management.md b/doc/contributing/feature-request-management.md new file mode 100644 index 00000000000..45774869cd1 --- /dev/null +++ b/doc/contributing/feature-request-management.md @@ -0,0 +1,89 @@ +# Feature request management + +Feature requests are a valuable source of input to the project. +They help our maintainers understand what additions will be of +value to users of the Node.js runtime. + +At the same time, the project is volunteer run and does not +have the ability to direct resources toward specific work. The +features which are implemented are those for which volunteers +are individually motivated to work on. The best way to ensure +a feature gets implemented is to create a PR to add it. +The project strives to support people who do that. + +An open feature request does not provide any indication that work +on that feature will take place and after some period of time +may be detrimental as it may result in an expectation that will +never be fulfilled. + +This process tries to balance retaining the valuable input +we get through feature requests and the overhead of +maintaining open feature requests that will never get +implemented. + +## Creating feature requests + +A feature request can be created by adding the `feature request` +label to an issue. This may be done automatically when the issue +is opened or at a later point (often when investigation of a bug +report results in it being considered a feature request as opposed +to a bug). + +The current list of feature requests can be found through the +[is:issue is:open label:"feature request"](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22feature+request%22) query. + +## Triage of feature requests + +There is no set process for triaging/handling feature requests. +Individual collaborators review issues marked as `feature request` +along with other issues and may or may not decide to +work on an implementation or advocate on their behalf. + +If a collaborator believes a feature request must be implemented +they can add the `never-stale` label to the issue and it will +be excluded from the automated feature request handling +as outlined below. + +## Expressing support for a feature request + +If you come across a feature request and want to add your +support for that feature please express your support +with the thumbs up emoji as a reaction. At some point in the +future we may use this as additional input in the automated +handling of feature requests. + +## Automated feature request handling + +Our experience is that most feature requests that are +likely to be addressed, will be addressed within the first +6 months after they are submitted. + +Once there has been no activity on a feature request for +5 months, the following comment will be added +to the issue: + +```markdown +There has been no activity on this feature request for +5 months and it is unlikely to be implemented. +It will be closed after 6 months after the last non-automated comment unless there is renewed +discussion or collaborators advocating that it be kept +open. For more information on how the project manages +feature requests please consult the +[feature request management document](https://github.com/nodejs/node/blob/HEAD/doc/guides/feature-request-management.md). +``` + +If there is no additional activity/discussion on the +feature request in the next month, the following +comment is added to the issue and the issue will be +closed: + +```markdown +There has been no activity on this feature request +and it is being closed. We value your input +and if you feel closing this issue was not the +right thing to do, please re-open it. + +For more information on how the project manages +feature requests please consult the +[feature request management document](https://github.com/nodejs/node/blob/HEAD/doc/guides/feature-request-management.md). +``` |