go-ethereum/docs/developers/geth-developer/contributing.md

35 lines
2.7 KiB
Markdown
Raw Normal View History

2022-09-09 07:28:25 -05:00
---
title: Contributing
2022-11-25 11:34:46 -06:00
description: Guidelines for contributing to Geth
2022-09-09 07:28:25 -05:00
---
We welcome contributions from anyone on the internet, and are grateful for even the smallest of fixes!
2022-11-25 11:34:46 -06:00
## Contributing to the Geth source code {#contributing-to-source-code}
2022-09-09 07:28:25 -05:00
2022-12-01 05:20:38 -06:00
If you'd like to contribute to the Geth source code, please fork the [GitHub repository](https://github.com/ethereum/go-ethereum), fix, commit and send a pull request for the maintainers to review and merge into the main code base. If you wish to submit more complex changes though, please check up with the core devs first on our Discord Server to ensure those changes are in line with the general philosophy of the project and/or get some early feedback which can make both your efforts much lighter as well as our review and merge procedures quick and simple.
2022-09-09 07:28:25 -05:00
Please make sure your contributions adhere to our coding guidelines:
- Code must adhere to the official Go formatting guidelines (i.e. uses gofmt).
- Code must be documented adhering to the official Go commentary guidelines.
- Pull requests need to be based on and opened against the master branch.
- Commit messages should be prefixed with the package(s) they modify.
E.g. "eth, rpc: make trace configs optional"
Pull requests generally need to be based on and opened against the `master` branch, unless by explicit agreement because the work is contributing to some more complex feature branch.
2022-11-17 13:50:52 -06:00
All pull requests will be reviewed according to the [Code Review guidelines](/docs/developers/geth-developer/code-review-guidelines).
2022-09-09 07:28:25 -05:00
We encourage an early pull request approach, meaning pull requests are created as early as possible even without the completed fix/feature. This will let core devs and other volunteers know you picked up an issue. These early PRs should indicate 'in progress' status.
2022-11-25 11:34:46 -06:00
## Contributing to the Geth website {#contributing-to-website}
2022-09-09 07:28:25 -05:00
The Geth website is hosted on a separate branch of `go-ethereum` from the source code. To contribute, please check out the website branch and raise pull requests for the maintainers to review and merge. Please note that new pages added to the site must also be added to `/src/data/documentation-links.yaml` in order for it to be included in the navigation sidebar. Additional contribution guidelines are available in the website [README](https://github.com/ethereum/go-ethereum/tree/website#readme).
2022-09-09 07:28:25 -05:00
2022-11-25 11:34:46 -06:00
## License {#license}
2022-09-09 07:28:25 -05:00
The go-ethereum library (i.e. all code outside of the cmd directory) is licensed under the GNU Lesser General Public License v3.0, also included in our repository in the COPYING.LESSER file.
The go-ethereum binaries (i.e. all code inside of the cmd directory) is licensed under the GNU General Public License v3.0, also included in our repository in the COPYING file.