CONTRIBUTING.md

Contributing to Elemental

Elemental accepts contributions via GitHub issues and pull requests. This document outlines the process to get your pull request accepted.

Elemental does accept external contributions in general, however the team's time is limited.

Elemental is on a quarterly release cycle, so it might take a long time for external contributions to be commented on, let alone reviewed and merged. We expect review times to improve in the future.

Start With An Issue

Prior to creating a pull request it is a good idea to create an issue. This is especially true if the change request is something large. The bug, feature request, or other type of issue can be discussed prior to creating the pull request. This can reduce rework.

Pull Requests

Pull requests for a code change should reference the issue they are related to.

This will enable issues to serve as a central point of reference for a change. For example, if a pull request fixes or completes an issue the commit or pull request should include:

Refers #123

In this case 123 is the corresponding issue number.

We leave issues open, until the quality assurance team reviewed them.

Semantic Versioning

Elemental follows semantic versioning.

This does not cover other tools included in Elemental.

Coding Style

Elemental expects its Go code to be formatted with goimports.

Elemental further follows the style guidelines at

• Effective Go and
• Go Wiki Code Review Comments
• Go Style At Google