Contributing to the Brightway Code#
If you would like to contribute to the development of Brightway, follow the usual GitHub process: Fork the relevant Brightway repository on GitHub, make your changes and open a pull request with your changes. The Brightway project has adopted the Contributor Covenant.
Contributing to the Brightway Documentation#
The processing of all requests is handled on a best-effort basis by the community of Brightway developers.
Option 1: Request Changes or Report Errors#
Create a new discussion in the
ideas section of the
brightway-documentation repository, detailing your request and all relevant information.
Option 2: Contribute Changes#
This is recommended for Brightway users with limited experience in software development and version control tools.
basic knowledge of GitHub (issues, discussions, etc.)
basic knowledge of Markup
Prepare your contribution using the Markdown (
.md) syntax and save it to a single file.
Start a new discussion in the
ideassection of the
brightway-documentationrepository and attach the Markdown file to the discussion. The discussion must include the intended location of your page in the Brightway documentation.
A member of the Brightway developers community will integrate your contribution into the documentation.
This is recommended for Brightway users with experience in software development and version control tools. The technical infrastructure of the Brightway documentation is detailed on the Contributing Guide pages for the General Documentation and the API Documentation.
knowledge of GitHub (pull-requests, etc.)
basic knowledge of Sphinx
Add your contributions and build the documentation locally (compare the repository readme)
Open a pull request
A member of the Brightway developers community will merge your contribution into the main branch of the documentation repository. Your changes will be published to the documentation website automatically following the successful merge.