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
====================

If you find a bug in this documentation or would like to propose an
improvement, please submit a bug report on the tracker.  If you have a
suggestion how to fix it, include that as well.

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: Documentation bugs on the Python issue tracker


Używanie systemu zgłoszeń Pythona
=================================

Zgłoszenia błędów w Pythonie powinny być zgłaszane przez Python Bug
Tracker (https://bugs.python.org/). System zgłoszeń posiada formularz
web, który pozwala wprowadzić stosowne informacje i wysłać je
deweloperom.

Pierwszym krokiem przy wypełnianiu zgłoszenia jest ustalenie, czy
problem został już zgłoszony. Zaletą tego ustalenia, oprócz
oszczędzenia czasu deweloperów, jest to, że dowiesz się, co zostało
zrobione, aby go naprawić; być może problem został już naprawiony na
następne wydanie lub potrzebne są dodatkowe informacje (w tym
przypadku zapraszamy cię, żebyś je podał, jeśli możesz!). Aby to
zrobić, przeszukaj bazę zgłoszeń używając pola wyszukiwania na górze
strony.

Jeśli problemu, który zgłaszasz, nie ma jeszcze w bug trackerze, wróć
do Python Bug Trackera i zaloguj się. Jeśli nie masz jeszcze konta w
trackerze, wybierz link „Register” lub, jeśli używasz OpenID, jedno z
logo providerów OpenID w sidebarze. Nie da się wysłać zgłoszenia błędu
anonimowo.

Będąc teraz zalogowanym, możesz zgłosić buga. Wybierz link „Create
New” w sidebarze, aby otworzyć formularz zgłaszania błędu.

Formularz zgłoszeniowy ma wiele pól. W polu „Title” wprowadź *bardzo*
krótki opis problemu; mniej niż dziesięć słów jest dobrze. W polu
„Type” wybierz typ swojego problemu; wybierz również „Component” i
„Versions”, z którymi bug jest związany.

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).

Każde zgłoszenie błędu zostanie przypisane do dewelopera, który
zdecyduje, co należy zrobić, aby naprawić problem. Dostaniesz
aktualizację za każdym razem, gdy na bugu zostanie wykonana jakaś
akcja.

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
     Informacje o pisaniu dobrych zgłoszeń błędów. Niektóre z nich są
     specyficzne dla projektu Mozilla, ale opisują ogólne dobre
     praktyki.


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.
