Contributing
We appreciate your interest in contributing to the project! To make the contribution process smooth and efficient, please follow the guidelines outlined below.
How to Contribute
-
Fork the Repository
Start by forking the repository on GitHub. This creates a personal copy of the repository where you can freely make changes. -
Create a New Branch
It’s essential to work on a separate branch instead of directly on themain
ormaster
branch. Create a new branch for the changes you intend to make.git checkout -b feature-name
-
Make Your Changes
Make your changes, and ensure that your code adheres to the existing code style. If you are adding a new feature, ensure that it is well documented. If you are fixing a bug, ensure that the bug is thoroughly addressed and tested. -
Commit Your Changes
Once you're happy with your changes, commit them to your branch. Write clear and concise commit messages that explain the changes you made.git commit -m "Your clear and concise commit message"
-
Push Changes to Your Fork
Push your changes to the repository on GitHub.git push origin feature-name
-
Submit a Pull Request (PR)
Once your changes are pushed to your fork, go to the original repository and submit a pull request (PR). Make sure to describe the purpose of your changes, and link any relevant issues if applicable.
Code Style and Formatting
To ensure a clean and consistent codebase, please follow the guidelines below when contributing:
-
Naming Conventions
Use PascalCase for class names, method names, and properties. Use camelCase for local variables and parameters -
Indentation
Use consistent indentation -
Line Length
Keep line length short for better readability -
Commenting and Documentation
Write clear and concise comments for complex logic or functions. Use comments to explain the purpose of non-obvious code, but avoid obvious comments.
Pull Request Review
After submitting your pull request (PR):
- A maintainer will review your code.
- They may suggest improvements or request changes.
- Once the PR is approved, it will be merged into the main branch.
License
By submitting a contribution, you agree that your code is provided under the project’s LICENSE.
Acknowledgements
Thanks again for contributing! We value your time and effort to improve the project. Together, we can make it better!