2015-08-13 16:14:34 +00:00
|
|
|
# Contributing to Node.js
|
2012-12-30 23:36:47 +00:00
|
|
|
|
2017-12-15 15:46:30 +00:00
|
|
|
Contributions to Node.js include code, documentation, answering user questions,
|
|
|
|
running the project's infrastructure, and advocating for all types of Node.js
|
|
|
|
users.
|
2017-08-31 20:06:16 +00:00
|
|
|
|
|
|
|
The Node.js project welcomes all contributions from anyone willing to work in
|
2017-12-15 15:46:30 +00:00
|
|
|
good faith with other contributors and the community. No contribution is too
|
|
|
|
small and all contributions are valued.
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2017-12-15 15:46:30 +00:00
|
|
|
This guide explains the process for contributing to the Node.js project's core
|
|
|
|
`nodejs/node` GitHub Repository and describes what to expect at each step.
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2018-09-28 06:40:12 +00:00
|
|
|
## Contents
|
|
|
|
|
|
|
|
* [Code of Conduct](#code-of-conduct)
|
|
|
|
* [Issues](#issues)
|
|
|
|
* [Pull Requests](#pull-requests)
|
|
|
|
* [Developer's Certificate of Origin 1.1](#developers-certificate-of-origin-11)
|
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
## [Code of Conduct](./doc/guides/contributing/coc.md)
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
The Node.js project has a
|
|
|
|
[Code of Conduct](https://github.com/nodejs/admin/blob/master/CODE_OF_CONDUCT.md)
|
|
|
|
that *all* contributors are expected to follow. This code describes the
|
|
|
|
*minimum* behavior expectations for all contributors.
|
2015-11-11 15:33:43 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
See [details on our policy on Code of Conduct](./doc/guides/contributing/coc.md).
|
2015-11-11 15:33:43 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
## [Issues](./doc/guides/contributing/issues.md)
|
2017-08-31 20:06:16 +00:00
|
|
|
|
|
|
|
Issues in `nodejs/node` are the primary means by which bug reports and
|
2018-01-20 15:19:03 +00:00
|
|
|
general discussions are made.
|
2015-01-02 11:52:50 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
* [How to Contribute in Issues](./doc/guides/contributing/issues.md#how-to-contribute-in-issues)
|
|
|
|
* [Asking for General Help](./doc/guides/contributing/issues.md#asking-for-general-help)
|
|
|
|
* [Discussing non-technical topics](./doc/guides/contributing/issues.md#discussing-non-technical-topics)
|
|
|
|
* [Submitting a Bug Report](./doc/guides/contributing/issues.md#submitting-a-bug-report)
|
|
|
|
* [Triaging a Bug Report](./doc/guides/contributing/issues.md#triaging-a-bug-report)
|
|
|
|
* [Resolving a Bug Report](./doc/guides/contributing/issues.md#resolving-a-bug-report)
|
2015-01-02 11:52:50 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
## [Pull Requests](./doc/guides/contributing/pull-requests.md)
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2018-01-01 05:14:52 +00:00
|
|
|
Pull Requests are the way concrete changes are made to the code, documentation,
|
|
|
|
dependencies, and tools contained in the `nodejs/node` repository.
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2018-01-20 15:19:03 +00:00
|
|
|
* [Dependencies](./doc/guides/contributing/pull-requests.md#dependencies)
|
|
|
|
* [Setting up your local environment](./doc/guides/contributing/pull-requests.md#setting-up-your-local-environment)
|
|
|
|
* [The Process of Making Changes](./doc/guides/contributing/pull-requests.md#the-process-of-making-changes)
|
|
|
|
* [Reviewing Pull Requests](./doc/guides/contributing/pull-requests.md#reviewing-pull-requests)
|
|
|
|
* [Additional Notes](./doc/guides/contributing/pull-requests.md#additional-notes)
|
2017-08-31 20:06:16 +00:00
|
|
|
|
2016-04-18 17:01:51 +00:00
|
|
|
<a id="developers-certificate-of-origin"></a>
|
2016-02-09 22:07:49 +00:00
|
|
|
## Developer's Certificate of Origin 1.1
|
2014-10-01 20:40:32 +00:00
|
|
|
|
|
|
|
By making a contribution to this project, I certify that:
|
|
|
|
|
|
|
|
* (a) The contribution was created in whole or in part by me and I
|
2016-02-09 22:07:49 +00:00
|
|
|
have the right to submit it under the open source license
|
|
|
|
indicated in the file; or
|
|
|
|
|
2014-10-01 20:40:32 +00:00
|
|
|
* (b) The contribution is based upon previous work that, to the best
|
2016-02-09 22:07:49 +00:00
|
|
|
of my knowledge, is covered under an appropriate open source
|
|
|
|
license and I have the right under that license to submit that
|
|
|
|
work with modifications, whether created in whole or in part
|
|
|
|
by me, under the same open source license (unless I am
|
|
|
|
permitted to submit under a different license), as indicated
|
|
|
|
in the file; or
|
|
|
|
|
2014-10-01 20:40:32 +00:00
|
|
|
* (c) The contribution was provided directly to me by some other
|
2016-02-09 22:07:49 +00:00
|
|
|
person who certified (a), (b) or (c) and I have not modified
|
|
|
|
it.
|
|
|
|
|
|
|
|
* (d) I understand and agree that this project and the contribution
|
|
|
|
are public and that a record of the contribution (including all
|
|
|
|
personal information I submit with it, including my sign-off) is
|
|
|
|
maintained indefinitely and may be redistributed consistent with
|
|
|
|
this project or the open source license(s) involved.
|