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.


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