Thank you for your interest in contributing to Commit-Craft! Contributing to an open-source project is a fantastic way to learn, share knowledge, and build a community. Below are the guidelines to help you contribute effectively.
If you’ve found a bug, have an idea for a new feature, or noticed something that needs improvement, please report it in the [Issues]:(LINK_TO_ISSUES) section.
When reporting an issue, try to include:
- A detailed description of the problem.
- Steps to reproduce the issue (if applicable).
- Information about your environment (software version, operating system, etc.).
Would you like to add a new feature? You can also submit a proposal in the Issues; section. Please include details such as:
- What value the feature will bring.
- Examples of how it might be used.
If you’d like to make changes to the code directly, follow these steps:
-
Fork the repository: Click the "Fork" button at the top of the repository page.
-
Clone the repository to your local machine:
git clone https://github.com/KamilAdd-Byte/commit-craft.git
-
Create a branch: Before starting your work, create a new branch:
git checkout -b <number-issue>feature-name
-
Make your changes: Edit the code, add new features, or fix bugs.
-
Update the documentation: Ensure that your changes are appropriately documented.
-
Run tests: Before submitting changes, verify that everything works correctly and that all tests pass.
-
Push your changes: Use Conventional Commits to format your commit messages. For example:
git add .
git commit -m "[Number-issue]feat: add new feature description"
git push origin <number-issue>feature-name
-
Create a Pull Request (PR): Go to your fork’s page and click "New Pull Request."
When creating the PR:
- Describe what you changed.
- Explain why the changes are necessary.
- Follow the [coding standard].
- Add comments to make the code more understandable.
- Write tests for new features.
- Avoid making large changes in a single PR; instead, split them into smaller parts.
- If you have questions, you can post them in the Discussions section or email us at [[email protected]].
Thank you for your time and effort. Together, we can build something amazing! 🎉