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.
