2014-02-08 15:31:01 +00:00
|
|
|
# Contributing to Node-RED
|
|
|
|
|
|
|
|
We welcome contributions, but request you follow these guidelines.
|
|
|
|
|
2015-02-06 13:16:46 +00:00
|
|
|
- [Raising issues](#raising-issues)
|
|
|
|
- [Feature requests](#feature-requests)
|
|
|
|
- [Pull-Requests](#pull-requests)
|
|
|
|
- [Contributor License Agreement](#contributor-license-agreement)
|
2015-04-27 20:03:14 +00:00
|
|
|
|
2016-04-07 20:13:40 +00:00
|
|
|
This project adheres to the [Contributor Covenant 1.4](http://contributor-covenant.org/version/1/4/).
|
2016-04-07 19:49:44 +00:00
|
|
|
By participating, you are expected to uphold this code. Please report unacceptable
|
2018-01-26 14:59:41 +00:00
|
|
|
behavior to the project's core team at team@nodered.org.
|
2016-04-07 19:49:44 +00:00
|
|
|
|
2014-02-08 15:31:01 +00:00
|
|
|
## Raising issues
|
|
|
|
|
2015-04-27 20:03:14 +00:00
|
|
|
Please raise any bug reports on the relevant project's issue tracker. Be sure to
|
2014-02-08 15:31:01 +00:00
|
|
|
search the list to see if your issue has already been raised.
|
|
|
|
|
|
|
|
A good bug report is one that make it easy for us to understand what you were
|
|
|
|
trying to do and what went wrong.
|
|
|
|
|
|
|
|
Provide as much context as possible so we can try to recreate the issue.
|
|
|
|
If possible, include the relevant part of your flow. To do this, select the
|
|
|
|
relevant nodes, press Ctrl-E and copy the flow data from the Export dialog.
|
|
|
|
|
2014-02-27 16:38:35 +00:00
|
|
|
At a minimum, please include:
|
|
|
|
|
|
|
|
- Version of Node-RED - either release number if you downloaded a zip, or the first few lines of `git log` if you are cloning the repository directly.
|
2019-08-06 10:27:46 +00:00
|
|
|
- Version of Node.js - what does `node -v` say?
|
2014-02-27 16:38:35 +00:00
|
|
|
|
2015-02-06 13:16:46 +00:00
|
|
|
## Feature requests
|
2014-02-08 15:31:01 +00:00
|
|
|
|
2018-05-17 11:17:55 +00:00
|
|
|
For feature requests, please raise them on the [forum](https://discourse.nodered.org).
|
2014-02-08 15:31:01 +00:00
|
|
|
|
|
|
|
## Pull-Requests
|
|
|
|
|
2015-02-06 13:16:46 +00:00
|
|
|
If you want to raise a pull-request with a new feature, or a refactoring
|
2015-04-27 20:03:14 +00:00
|
|
|
of existing code, it may well get rejected if you haven't discussed it on
|
2018-05-17 11:17:55 +00:00
|
|
|
the [forum](https://discourse.nodered.org) first.
|
2014-02-08 15:31:01 +00:00
|
|
|
|
2016-12-09 13:35:29 +00:00
|
|
|
All contributors need to sign the JS Foundation's Contributor License Agreement.
|
|
|
|
It is an online process and quick to do. You can read the details of the agreement
|
|
|
|
here: https://cla.js.foundation/node-red/node-red.
|
2014-02-08 15:31:01 +00:00
|
|
|
|
2016-12-09 13:35:29 +00:00
|
|
|
If you raise a pull-request without having signed the CLA, you will be prompted
|
|
|
|
to do so automatically.
|
2014-02-08 15:31:01 +00:00
|
|
|
|
|
|
|
|
2015-02-06 13:16:46 +00:00
|
|
|
### Coding standards
|
|
|
|
|
|
|
|
Please ensure you follow the coding standards used through-out the existing
|
|
|
|
code base. Some basic rules include:
|
|
|
|
|
|
|
|
- all files must have the Apache license in the header.
|
|
|
|
- indent with 4-spaces, no tabs. No arguments.
|
2015-04-27 20:03:14 +00:00
|
|
|
- opening brace on same line as `if`/`for`/`function` and so on, closing brace
|
|
|
|
on its own line.
|