Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nodejs/node.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichael Dawson <mdawson@devrus.com>2022-01-06 23:51:38 +0300
committerMichael Dawson <mdawson@devrus.com>2022-02-04 23:54:21 +0300
commit6c0eb942b3d1851773fd31adf7b8cd2e6ccb405a (patch)
treedf694ac88ca3bf54543a855e032c7f25d45c2da0 /doc
parent9e892e22e36c1186ff11cb050c33e5945c52c99d (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.md89
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).
+```