Contribute to ESL

Hello, potential ESL contributor! We are really glad you are going to support ESL. But before submitting your contribution, please make sure to take a moment and read through the following guidelines:

To maintain polite and constructive discussions within the project, please follow the Code Of Conduct guide.

Creating an issue

In case you are going to create a new issue for a bug or feature request, please use prepared issues templates and make sure you provide all required information to understand your request. Also, please try to make sure that the issue for the bug or feature you are going to create is not present in the issues list.

Please don't be shy to suggest new features, improvements or notify us about any bugs. We are open to all suggestions and will do our best to keep the project bug-free.

Creating a Pull Request

If you are going to contribute to the project with the code changes, check out our Development Guide and Commit Message Convention.

Outside Contributions Process

Project Branches and Releases

ESL internal branches flow is described in the scheme below
branches flow

The following branches are used in the project:

The following merge flows can be done by all ESL official collaborators:

Contribute to ESL documentation

Found a typo or just want to improve ESL documentation? Feel free to create a PR with your changes. You don't need special knowledge or even an open IDE to do this. All ESL documentation is written in markdown and available in the module directory in src/module/esl-*/README.md files.

Use the following steps to suggest an update to the ESL documentation quickly:

  1. Find the right markdown file on GitHub
  2. Click the "Edit this file" link with a pencil icon in the top right corner of the page
  3. Make a fork of the repository and create a new branch for your changes
  4. Make your changes and check the preview
  5. Click on the "Commit changes" button and create a fork of the branch
  6. Fill commit message and description
  7. Make sure the commit name starts with docs: (or docs(esl-*changed module*): ) prefix
  8. Click the "Propose changes" button
  9. Confirm your CLA agreement (you will be asked to do this the first time you contribute to the project)
  10. You have really helped us to improve the ESL documentation. Thank you!