First off, thank you for considering contributing to this project.
Please follow these guidelines for helping us to better address your issue, assessing changes, and helping you finalize your pull requests. There are many ways to contribute, from writing examples, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into the module itself.
This project adheres to the Contributor Covenant Code of Conduct, please read it and follow it before contributing. If you find someone that is not respecting it please report its behaviour.
There are several ways to contribute. You can fork the repository and propose a Pull Request, or you can start a discussion to report a bug, an indesired behavior of the application, or to simply suggest a feature.
Before opening a new thread, please verify whether there's already a discussion about the topic of your interest. You can find them:
- in the issues tab;
- in the official Mia Platform Community Discussion page;
If you find a bug, or you notice something that should be modified or improved, you can do so in the Issues section.
Before doing that, please search if there isn’t already a similar issue already open. If you find a similar issue that is already closed, open a new one and include a link to it inside the body of the new one.
Before starting to implement a new feature, open the relative issue for starting an open discussion on where is can be relevant and expose alternative solutions or potential pitfall that you can encounter. Fill all the information required by the template.
Any update to the code must be tested properly. We can refer to the Local Development section of the README. Please make sure that any update you want to propose includes enough tests, and the old ones pass as well.
- Commits should follow standards:
<type>(<scope>): <subject>
(e.g.feat(core): Add new feature
) - In the
Unreleased
section in CHANGELOG.md, compile the changelog adding the improvement added in the PR. Changelog should follow the Keep a Changelog standard.
If you want to fork our project, you could make it and keep in sync with our template. All contribution which could improve the existent code base are welcome!
To keep a fork up to date, you can follow this GitHub guide. For all the information about forks, see this link.