Skip to content

Neon’s Community and How to Contribute

The Neon team strongly believes in the open-source effort and we welcome and greatly appreciate contributions from the community: proposing new features, filing issues, and contributing code. The rest of the document describes various processes to give your contribution.

Providing Suggestions

Neon is meant to evolve with feedback from the community, and we greatly appreciate any thoughts on ways to improve the design or features. Please use the enhancement tag to denote issues that are suggestions specifically—this helps us triage and respond appropriately.

Filing Bugs

As with all software, you may run into bugs. Please submit bugs as regular issues on GitHub—we are regularly monitoring issues and will prioritize and schedule fixes.

The best bug reports include a detailed way to reproduce the issue predictably and possibly even a working example demonstrating the issue.

Contributing Code

There are three main steps for contributing your code to the project. First, sign a Contributor License Agreement, share your goal with the community, write your code following Neon coding standards, and finally, submit a pull request. Here are some more details on each of the steps.

Contributor License Agreement (CLA)

Before contributing any code to this project, we kindly ask you to sign a Contributor License Agreement (CLA). We can not accept any pull request if a CLA has not been signed.

  • If you are contributing on behalf of yourself, the CLA signature is included as a part of the pull request process.

  • If you are contributing on behalf of your employer, please sign our Corporate Contributor License Agreement. The document includes instructions on where to send the completed forms to. Once a signed form has been received, we can happily review and accept your pull requests.

Coordinate With the Community

We highly recommend opening an issue on GitHub to describe your goals before starting any coding. This will allow you to get early feedback and avoid multiple parallel efforts.

Coding Standard

To provide a more uniform code base, we would appreciate it if any new code could follow the coding standard described in this document: CodeConvention.md.

Git Workflow

We follow the GitFlow development model. If you would like to contribute your code to Neon, you should: - Include your work in a feature branch created from the Neon develop branch. The develop branch contains the latest work in Neon. - Then, create a pull request against the develop branch.

Periodically, we merge the develop branch into the main branch and tag a new release.

When contributing code, please include appropriate tests as part of the pull request, and follow the same comment and coding style as the rest of the project. Take a look through the existing code for examples of the testing and style practices the project follows.