We appreciate your interest in contributing to this project! This document outlines the process for submitting code, documentation, or other types of contributions. Please read and follow these guidelines to ensure a smooth collaboration with the project maintainers.
Before participating in the project, please read our Code of Conduct. By engaging with this repository and its respective community, you agree to abide by its terms.
- Fork the project on GitHub to your own account.
- If you are new to forking repositories, you can find a detailed guide on forking here.
- Clone your fork to your local development environment:
git clone git@github.com:bilbilak/refred.git cd bilbilak
- Make sure you have the necessary tools installed, such as Node.js and any dependencies required by the project.
NOTE: If you'd like to contribute to our documentation, please use MyRepos tool to clone the project's Wiki. You can initiate the clone by running mr checkout
as configured in the .mrconfig
file. This will create the sub-repository under the docs/wiki/
directory, separate from the main repository. To interact with this sub-repository, it's important to familiarize yourself with other mr
commands.
When contributing to this project, please adhere to the following guidelines:
...
- Create a new branch for your contribution:
git checkout -b feature/your-feature
- Make your changes and commit them with a descriptive message:
git add . git commit -m "Add a brief description of your changes"
- Writing clear and concise commit messages is important. For tips on how to write good commit messages, you can refer to this guide tailored for projects following the Gitflow approach.
- Push your changes to your fork on GitHub:
git push origin feature/your-feature
- Create a pull request on the project's GitHub repository, comparing the project's
develop
branch with your feature branch. - Fill out the pull request template with a description of your changes, and reference any relevant issues or discussions.
After submitting your pull request, the project maintainers will review your contribution. They may request changes or provide feedback before merging your changes into the development branch. Please be patient and address any comments or concerns raised by the maintainers.
💖 Thank you for your contribution! Your collaboration helps improve the project for everyone.