Thank you for considering contributing to our project! By contributing, you help us improve and grow. To ensure a smooth process for everyone involved, please take a moment to review these guidelines.
- How to Contribute
- Reporting Issues
- Submitting Pull Requests
- Coding Standards
- Commit Messages
- Branching Model
- Review Process
- License
- Ensure you have a GitHub account.
- Install Git.
- Fork the repository on GitHub.
- Clone your forked repository to your local machine.
git clone https://github.com/your-username/repository-name.git
- Create a new branch for your changes.
git checkout -b feature/branch-name
- Make your changes in the codebase.
- Commit your changes with a descriptive commit message.
- Push your changes to your forked repository.
git push origin feature/branch-name
- Create a Pull Request (PR) from your forked repository to the main repository.
If you find a bug or have a feature request, please create an issue. Make sure to include a clear title and description. Provide as much detail as possible to help us understand and address the issue.
- Ensure your code follows the project's coding standards.
- Make sure there are no conflicts with the base branch.
- Add tests for your changes (if applicable).
- Update the documentation (if applicable).
- Go to the original repository and navigate to the "Pull Requests" tab.
- Click the "New Pull Request" button.
- Select the
develop
branch and compare it with your feature branch. - Provide a descriptive title and a detailed description of your changes.
- Submit the PR for review.
- Follow the project's coding style (e.g., linting rules, naming conventions).
- Write clear, concise, and maintainable code.
- Include comments where necessary, especially for complex logic.
- Ensure your code is well-documented.
- Use the present tense ("Add feature" not "Added feature").
- Capitalize the first letter of the subject line.
- Limit the subject line to 50 characters or less.
- Separate the subject from the body with a blank line.
- Use the body to explain what and why vs. how.
main
: The production branch.develop
: The branch for ongoing development.
- Once you submit a PR, it will be reviewed by one or more maintainers.
- Reviewers may request changes or approve the PR.
- Address any feedback and push additional commits if necessary.
- Once approved, the PR will be merged into the appropriate branch.
By contributing to this project, you agree that your contributions will be licensed under the project's license.