2015-05-19 01:29:13 +00:00
# Contributing to Electron
:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
2015-12-04 00:06:58 +00:00
This project adheres to the Contributor Covenant [code of conduct ](CODE_OF_CONDUCT.md ).
By participating, you are expected to uphold this code. Please report unacceptable
2018-03-14 19:37:40 +00:00
behavior to coc@electronjs.org.
2015-07-08 20:23:06 +00:00
2015-05-19 01:29:13 +00:00
The following is a set of guidelines for contributing to Electron.
These are just guidelines, not rules, use your best judgment and feel free to
propose changes to this document in a pull request.
2018-02-12 14:09:38 +00:00
## [Issues](https://electronjs.org/docs/development/issues)
2015-05-19 01:29:13 +00:00
2018-02-12 14:09:38 +00:00
Issues are created [here ](https://github.com/electron/electron/issues/new ).
* [How to Contribute in Issues ](https://electronjs.org/docs/development/issues#how-to-contribute-in-issues )
* [Asking for General Help ](https://electronjs.org/docs/development/issues#asking-for-general-help )
* [Submitting a Bug Report ](https://electronjs.org/docs/development/issues#submitting-a-bug-report )
* [Triaging a Bug Report ](https://electronjs.org/docs/development/issues#triaging-a-bug-report )
* [Resolving a Bug Report ](https://electronjs.org/docs/development/issues#resolving-a-bug-report )
2015-05-19 01:29:13 +00:00
2019-10-14 16:40:01 +00:00
### Issue Closure
Bug reports will be closed if the issue has been inactive and the latest affected version no longer receives support. At the moment, Electron maintains its three latest major versions, with a new major version being released every 12 weeks. (For more information on Electron's release cadence, see [this blog post ](https://electronjs.org/blog/12-week-cadence ).)
_If an issue has been closed and you still feel it's relevant, feel free to ping a maintainer or add a comment!_
2017-09-29 22:37:45 +00:00
2019-06-19 22:41:32 +00:00
### Languages
We accept issues in *any* language.
2019-06-19 22:45:33 +00:00
When an issue is posted in a language besides English, it is acceptable and encouraged to post an English-translated copy as a reply.
2019-06-19 22:41:32 +00:00
Anyone may post the translated reply.
In most cases, a quick pass through translation software is sufficient.
Having the original text _as well as_ the translation can help mitigate translation errors.
Responses to posted issues may or may not be in the original language.
2019-06-19 22:52:11 +00:00
**Please note** that using non-English as an attempt to circumvent our [Code of Conduct ](https://github.com/electron/electron/blob/master/CODE_OF_CONDUCT.md ) will be an immediate, and possibly indefinite, ban from the project.
2019-06-19 22:41:32 +00:00
2018-02-12 14:09:38 +00:00
## [Pull Requests](https://electronjs.org/docs/development/pull-requests)
2015-05-19 01:29:13 +00:00
2018-02-12 14:09:38 +00:00
Pull Requests are the way concrete changes are made to the code, documentation,
dependencies, and tools contained in the `electron/electron` repository.
2015-05-19 01:29:13 +00:00
2018-02-12 14:09:38 +00:00
* [Setting up your local environment ](https://electronjs.org/docs/development/pull-requests#setting-up-your-local-environment )
* [Step 1: Fork ](https://electronjs.org/docs/development/pull-requests#step-1-fork )
* [Step 2: Build ](https://electronjs.org/docs/development/pull-requests#step-2-build )
* [Step 3: Branch ](https://electronjs.org/docs/development/pull-requests#step-3-branch )
* [The Process of Making Changes ](https://electronjs.org/docs/development/pull-requests#the-process-of-making-changes )
* [Step 4: Code ](https://electronjs.org/docs/development/pull-requests#step-4-code )
* [Step 5: Commit ](https://electronjs.org/docs/development/pull-requests#step-5-commit )
* [Commit message guidelines ](https://electronjs.org/docs/development/pull-requests#commit-message-guidelines )
* [Step 6: Rebase ](https://electronjs.org/docs/development/pull-requests#step-6-rebase )
* [Step 7: Test ](https://electronjs.org/docs/development/pull-requests#step-7-test )
* [Step 8: Push ](https://electronjs.org/docs/development/pull-requests#step-8-push )
* [Step 8: Opening the Pull Request ](https://electronjs.org/docs/development/pull-requests#step-8-opening-the-pull-request )
* [Step 9: Discuss and Update ](#step-9-discuss-and-update )
* [Approval and Request Changes Workflow ](https://electronjs.org/docs/development/pull-requests#approval-and-request-changes-workflow )
* [Step 10: Landing ](https://electronjs.org/docs/development/pull-requests#step-10-landing )
* [Continuous Integration Testing ](https://electronjs.org/docs/development/pull-requests#continuous-integration-testing )
2015-05-19 01:29:13 +00:00
2018-02-12 14:09:38 +00:00
## Style Guides
2015-05-19 01:29:13 +00:00
2018-02-12 14:09:38 +00:00
See [Coding Style ](https://electronjs.org/docs/development/coding-style ) for information about which standards Electron adheres to in different parts of its codebase.
2015-05-19 01:29:13 +00:00
2018-03-20 19:36:48 +00:00
## Further Reading
For more in-depth guides on developing Electron, see
2019-06-19 22:41:32 +00:00
[/docs/development ](/docs/development/README.md )
