This section guides you through submitting a bug report. Following these guidelines helps maintainers and the community understand your report 📝, reproduce the behaviour 💻 💻, and find related reports. 🔎
Since the new GitHub Issue forms, we only suggest you include the most information possible. But you can also Perform a cursory search to see if the enhancement has already been suggested. If it has, adds a comment to the existing issue instead of opening a new one.
Note: If you find a Closed issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.
Bugs are tracked as github issues. After you've determined which repository your bug is related to, create an issue on that repository.
Explain the problem and include additional details to help maintainers reproduce the problem:
-
Use a clear and descriptive title for the issue to identify the problem.
-
Describe the exact steps which reproduce the problem in as many details as possible.
-
Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
-
Explain which behavior you expected to see instead and why.
-
Include screenshots or animated GIFs which show you following the described steps and clearly demonstrate the problem. If you use the keyboard while following the steps, use this tool to record GIFs on macOS and Windows, and this tool or this tool on Linux.
1. Fork the repository. Click on the symbol at the top right corner.
2. Clone the forked repository.
git clone https://github.com/<your-username>/.github.git
3. Navigate to the project directory.
cd .github
4. Create a new branch (naming convention- type-description-issueNo)
Kindly give your branch a more descriptive name like docs-contributing-guide-2
instead of patch-1
.
You could follow this convention. Some ideas to get you started:
- Feature Updates:
feat-<brief 5-10 words-Description>-<ISSUE_NO>
- Bug Fixes:
fix-<brief 5-10 words-Description>-<ISSUE_NO>
- Documentation:
docs-<brief 5-10 words-Description>-<ISSUE_NO>
- And so on...
git checkout -b your-branch-name
5. Make the necessary changes.
6. Stage your changes and commit.
git add . # Stages all the changes
git commit -m "<your_commit_message>"
Your commit message should be something which gives concise idea of the issue you are solving.
7. Push your local commits to the remote repository.
git push origin your-branch-name
8. Create a new pull request from your-branch-name
🎉 Congratulations! You've made your first pull request! Now, you should just wait until the maintainers review your pull request.