CONTRIBUTING.md
October 15, 2025 ยท View on GitHub
Contribution Guidelines
Thank you for considering contributing to this project! Contributions are always welcome and appreciated.
How to Contribute
Please check the issue tracker to see if there is an issue you would like to work on or if it has already been resolved.
Reporting Bugs
- Open an issue on the issue tracker.
- Include information such as steps to reproduce the observed behavior and relevant logs or screenshots.
Suggesting Features
- Open an issue on the issue tracker.
- Provide details about the feature, its purpose, and potential implementation ideas.
Submitting Pull Requests
- Make sure all tests pass before submitting a pull request.
- Write a clear description of the changes you made and the reasons behind them.
Important
It's assumed that by submitting a pull request, you agree to license your contributions under the project's license.
Development Workflow
Prerequisites
Node.js >=20.0.0npmoryarnfor package managementGNU MakePython >=3.10andpipfor installingpre-commit
Development Setup
-
Install dependencies:
make installThis will install the necessary Node.js dependencies.
-
Set up Git hooks:
make setup-hooksThis will set up pre-commit hooks for linting and formatting.
Code Style
- Use the
make formatcommand to format the code.
Running Tests
- Use the
make testcommand to run the tests.
Running Linter Checks
- Use the
make lintcommand to run the linter checks.
See Available Commands
- Run
make helpto see all available commands for managing different tasks.
Code of Conduct
We adhere to the project's Code of Conduct.