First of all, thank you for taking the time to contribute! 🎉 The following is a set of guidelines for contributing to this project on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
This project follows the Contributor Covenant Code of Conduct.
If you find a bug, please report it by opening an issue. Before submitting, check if the issue has already been reported.
To help us address the issue, please include:
- A clear and descriptive title.
- Steps to reproduce the bug.
- Information about your environment (OS, browser, etc.).
- Any relevant error messages or logs.
Have an idea to improve the project? We'd love to hear about it!
To suggest an enhancement:
- Open an issue with a clear title and detailed description of the suggestion.
- Explain why this enhancement would be useful.
- Provide examples or mockups if applicable.
We welcome contributions of code! Here's how to get started:
- Fork the repository.
- Create a new branch (
git checkout -b feature/my-feature
). - Make your changes, including tests if necessary.
- Commit your changes (
git commit -am 'Add new feature'
). - Push to your fork (
git push origin feature/my-feature
). - Open a pull request and describe the changes you’ve made.
- Use present tense ("Add feature" not "Added feature").
- Use imperative mood ("Fix bug" not "Fixed bug").
- Keep the first line under 50 characters.
- Follow the existing code style in the repository.
- Write clear and descriptive comments.
- Include tests for new features or bug fixes.
If your contribution affects the functionality or interface, ensure the documentation is updated.
When submitting a pull request:
- Ensure that the pull request follows the repository's style.
- Include a detailed description of what the pull request does.
- Reference any related issues (e.g., "Closes #123").
- Wait for feedback from project maintainers, and be prepared to make changes.
By contributing to this project, you agree that your contributions will be licensed under the MIT License.