This document sets out the methods and practices for contributing to the Verovio project.
In order to contribute the the project you need to sign and send us ([email protected]) a Contributor License Agreement (CLA). However, following a generally accepted practice, very small contributions (below 20 lines of code) will be accepted without signing the CLA.
Adapted from the Music Encoding Initiative Guidelines.
Please use the "Pull Request" mechanism for proposing contributions to the code base. A brief overview of this process:
- Fork the
rism-ch/verovio
repository into your own account. - Create a dedicated branch from the
verovio:develop
branch for your developments on your repository. For example, you might create averovio:develop-noteheads
branch if you're proposing a developments for the note heads. - Make your changes. You can commit to your branch as many times as you like.
- When you're ready to provide your changes "upstream," you can open a pull request to the
rism-ch/verovio:develop
branch. NB: You will want to make sure you're proposing a merge todevelop
and notmaster
. - We will then review your submission. If you are asked to make changes, you can push these changes to your original branch and the pull request will be automatically updated.
- Once the changes have gone through our review process, we will merge your changes into our repository. You may then delete your dedicated branch.
For proposing changes to the verovio:gh-pages
branch of Verovio (e.g., its website), follow the same workflow but make the pull request to the rism-ch/verovio:gh-pages-develop
branch.