Zajmowanie się błędami¶
Python jest dojrzałym językiem programowania, z ustaloną reputacją swojej stabilności. Aby utrzymać tę stabilność, deweloperzy chcieliby wiedzieć o wszelkich brakach, które da się znaleźć w Pythonie.
Czasem szybsze może być własnoręczne naprawienie błędu i wysłanie patchy do Pythona, usprawnia to proces i angażuje mniej osób. Dowiedz się, jak kontrybuować.
Błędy w dokumentacji¶
Jeśli znajdziesz błąd w tej dokumentacji lub chciałbyś zaproponować poprawkę, wyślij, prosimy, zgłoszenie błędu do systemu. Jeśli masz sugestię, jak go naprawić, zawrzyj ją.
Jeśli brakuje ci czasu, możesz też wysyłać zgłoszenia błędów w dokumentacji na docs@python.org (błędy behawioralne mogą być wysyłane na python-list@python.org). «docs@» jest listą mailingową prowadzoną przez wolontariuszy; twoje zgłoszenie zostanie zauważone, aczkolwiek jego przetworzenie może chwilę zająć.
Zobacz także
- Błędy w dokumentacji
Lista błędów w dokumentacji, które zostały wysłane do systemu zgłoszeń błędów Pythona.
- Śledzenie zgłoszeń
Omówienie procesu zgłaszania poprawki w systemie zgłoszeń.
- Pomoc w dokumentacji
Wyczerpujący przewodnik dla osób zainteresowanych rozwijaniem dokumentacji Pythona.
- Documentation Translations
A list of GitHub pages for documentation translation and their primary contacts.
Używanie systemu zgłoszeń Pythona¶
Issue reports for Python itself should be submitted via the GitHub issues tracker (https://github.com/python/cpython/issues). The GitHub issues tracker offers a web form which allows pertinent information to be entered and submitted to the developers.
The first step in filing a report is to determine whether the problem has already been reported. The advantage in doing so, aside from saving the developers» time, is that you learn what has been done to fix it; it may be that the problem has already been fixed for the next release, or additional information is needed (in which case you are welcome to provide it if you can!). To do this, search the tracker using the search box at the top of the page.
If the problem you’re reporting is not already in the list, log in to GitHub. If you don’t already have a GitHub account, create a new account using the „Sign up” link. It is not possible to submit a bug report anonymously.
Being now logged in, you can submit an issue. Click on the „New issue” button in the top bar to report a new issue.
The submission form has two fields, „Title” and „Comment”.
For the „Title” field, enter a very short description of the problem; less than ten words is good.
W polu „Comment” opisz problem szczegółowo, zawierając informacje o tym, czego się spodziewałeś, aby się stało i co się stało zamiast. Zawrzyj informację, czy dotyczy to jakiegokolwiek modułu rozszerzeń i platform hardware’owych i software’owych, których używałeś (oraz informacje o wersjach).
Each issue report will be reviewed by a developer who will determine what needs to be done to correct the problem. You will receive an update each time an action is taken on the issue.
Zobacz także
- How to Report Bugs Effectively
Artykuł, który dość szczegółowo opisuje, jak stworzyć wartościowe zgłoszenie błędu. Opisuje jakie rodzaje informacji są przydatne i dlaczego.
- Bug Writing Guidelines
Information about writing a good bug report. Some of this is specific to the Mozilla project, but describes general good practices.
Rozpoczęcie rozwijania Pythona samemu¶
Oprócz tylko zgłaszania błędów, które znajdziesz, jesteś również zaproszony do wysyłania patchy naprawiających je. Więcej informacji o tym, jak zacząć patchować Pythona, znajdziesz w Python Developer’s Guide. Jeśli masz pytania, lista mailingowa core-mentorship jest przyjaznym miejscem do uzyskiwania odpowiedzi na każde pytanie typowe dla procesu naprawiania błędów w Pythonie.