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.

Wytyczne odnośnie pisania zgłoszeń błędów (w języku angielskim)

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.