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:
- 🔗 Code Of Conduct
- 🔗 Contributor Licence Agreement
- Creating an issue
- Creating a Pull Request
- Contributing to ESL Documentation
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
Outside Contributions Process
- Fork the repository and prepare an update in the proper branch of your fork. Use one of the
tech/*prefixes for the branch. Use
mainbranch as the base.
- Make sure your commits follow the project commit convention.
- Make sure that all tests and linter checks are passed.
- Create a pull request from your fork branch to the ESL repository.
It's strongly recommended to use
main-betabranch as a target.
ESL maintainers will rebase your PR to the
mainbranch (if it's approved for the next ESL version), or move it under the proper project's "epic".
- Please use Pull Request Template and be sure to add
- Don't forget to sign the project CLA. The CLA bot will automatically prompt you to do it. We cannot use your contribution to the project without this.
Project Branches and Releases
ESL internal branches flow is described in the scheme below
The following branches are used in the project:
mainbranch has the current or the nearest stable release of the library
main-betabranch has the next minor and major releases changes
epic/new-big-feature) - a branch for new complex functionality or a group of related features
feature/*- a branch for a feature implementation
bugfix/*- a branch for a bugfix implementation
docs/*- a branch with the documentation or demo content updates (TS Docs, GHPages content, README, etc.)
tech/*- common updates regarding the build process, configuration, linters, and other technical changes that are not affecting library output (npm package)
The following merge flows can be done by all ESL official collaborators:
epic/*(if the epic is not going to be a part of the current stable major release)
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
Use the following steps to suggest an update to the ESL documentation quickly:
- Find the right markdown file on GitHub
- Click the "Edit this file" link with a pencil icon in the top right corner of the page
- Make a fork of the repository and create a new branch for your changes
- Make your changes and check the preview
- Click on the "Commit changes" button and create a fork of the branch
- Fill commit message and description
- Make sure the commit name starts with
docs(esl-*changed module*):) prefix
- Click the "Propose changes" button
- Confirm your CLA agreement (you will be asked to do this the first time you contribute to the project)
- You have really helped us to improve the ESL documentation. Thank you!