How to File a Bug Report on GitHub

That’s awesome! Here’s how it works:

1. To start, make sure the problem hasn’t already been reported by searching for it using the search box at the top of the page. This saves everyone time and effort because maybe someone else has already fixed it or needs more information to do so. 2. If you can’t find anything related to your issue, log in to GitHub (if you don’t have an account yet, sign up using the “Sign Up” link) and click on the “New Issue” button at the top of the page. This will open a form where you can enter some basic information about what went wrong. 3. In the “Title” field, write a short description of your problem (fewer than ten words is good). For example: “Can’t install package on Ubuntu.”

4. In the “Comment” field, provide more details about what happened and any relevant information that might help someone fix it. Be sure to include things like which version of Python you were using, whether any extension modules were involved, and what hardware and software platform you were working with (including version info as appropriate). 5. Once you’ve submitted your issue report, a developer will review it and determine what needs to be done to correct the problem. You’ll receive updates each time an action is taken on the issue.

6. If you want to practice writing comments for yourself or help others by commenting their code, start small! Add simple comments where necessary in your own code, and put docstrings at the top of all your scripts. Review old code that you’ve written and add clarifying comments as needed. 7. When submitting changes via pull request (PR), sign them with your initials and date to help others understand who made what changes. If your PR is merged, it could potentially benefit dozens or even hundreds of developers like yourself!

8. Finally, if you’re interested in contributing to Python documentation, check out the “Helping with Documentation” guide for more information on how to get started. And don’t forget about the list of GitHub pages for documentation translation and their primary contacts!

SICORPS