How to report a bug/pl

Ten przewodnik wyjaśnia "jak prawidłowo zgłosić błędy w oprogramowaniu lub zaproponować nową funkcję" (zgłoszenie) w systemie śledzenia błędów Wikimedia (zobacz, aby uzyskać więcej informacji). Dobrze napisane zgłoszenia mają większe prawdopodobieństwo, że ktoś nad nimi popracuje.

Ogólne zalecenia odnośnie zgłoszeń

 * Bądź dokładny
 * Jasno określ jak doszło do sytuacji, w której wystąpił problem, krok po kroku, dzięki czemu inni będą mogli odtworzyć błąd lub zrozumieć zgłoszenie
 * W każdym zgłoszeniu opisuj tylko jeden problem
 * Dołączaj odpowiednie linki i przykłady

Czy możesz odtworzyć problem?
Spróbuj odtworzyć jeszcze raz swój błąd korzystając z najnowszej wersji oprogramowania, aby przekonać się, czy nie został on już naprawiony. Jeżeli znalazłeś błąd w serwisie wiki takim jak Wikipedia, możesz spróbować przetestować najnowszą wersję oprogramowania na test2.wikipedia.org.

Czy ktoś wcześniej zgłaszał ten problem?
Użyj pola wyszukiwania w bugtrackerzze Wikimedia, by upewnić się, czy znaleziony przez ciebie błąd nie został już zgłoszony. Możesz także przeprowadzić bardziej zaawansowane wyszukiwanie na stronie wyszukiwania zaawansowanego.

Jeżeli nie jesteś pewien czy błąd został zgłoszony, zgłoś go. Lepiej żeby było kilka takich samych zgłoszeń niż niezgłoszone błędy.

Zgłaszanie nowego błędu lub prośby o funkcję
Jeżeli napotkałeś błąd w najnowszej wersji i nie został on wcześniej zgłoszony to:
 * 1) Przejdź do phabricator.wikimedia.org i wybierz „Tasks & bugs” z paska bocznego.
 * 2) Wybierz „Create task” w prawym górnym rogu.
 * 3) Zostaniesz poproszony o zalogowanie (lub rejestrację), jeżeli tego wcześniej nie zrobiłeś (zobacz „”).
 * 4) Wypełnij przynajmniej jedno z poniższych pól (szczegółowe opisy):
 * 5) * Title (Tytuł): Krótkie, jednozdaniowe podsumowanie, które wyjaśnia problem (nie propozycja rozwiązania).
 * 6) ** Dobrze:
 * 7) ** Źle:
 * 8) * Assigned To (Przypisane do): Powinieneś zignorować to pole: deweloperzy przypiszą osobę, gdy rozpoczną planowanie pracy nad zadaniem.
 * 9) * Description (Opis): Pełny opis problemu, podaj tak dużo szczegółów, jak to jest możliwe. Mogą zawierać:
 * 10) ** W przypadku błędów:
 * 11) *** Steps to Reproduce (kroki do odtworzenia): kroki, które należy przejść aby spowodować opisywany problem.
 * Przykład:
 * 1) *** Actual Results (aktualne rezultaty): Jak program zachował się po wykonaniu powyższych kroków.
 * Przykład:
 * 1) ***Expected Results (oczekiwane rezultaty): Jak aplikacja powinna się zachować gdyby nie było tego błędu.
 * Przykład:
 * 1) ** W przypadku propozycji nowych funkcji:
 * 2) *** Opis tego, co chcesz osiągnąć i dlaczego. User story jest skutecznym sposobem na przekazanie tego.
 * Przykład:
 * 1) **Podaj też inne informacje, które mogą być przydatne, takie jak:
 * 2) ***przeglądarki internetowe, skórki lub systemy komputerowe, na których widać błąd;
 * 3) ***łącza lub odnośniki do wersji jednej lub więcej stron, na których wystąpił błąd; lub
 * 4) ***czy problem występuje za każdym razem, tylko od czasu do czasu, tylko na niektórych stronach, czy tylko w określonych okolicznościach.
 * 5) *Aby załączyć plik dziennika lub (upewnij się, że nie zawierają bądź przedstawiają one poufnych danych), naciśnij przycisk Wyślij plik (chmurka ze strzałką) w pasku narzędzi pola Opis.
 * 6) * Wybierz znaczniki (projektu/projektów) ze znalezionym błędem:
 * 7) **Projekty określają, jakich zadań poszukują twórcy do pracy. Aby zidentyfikować właściwy projekt, skorzystaj z funkcji wyszukiwania (w prawym górnym rogu), aby znaleźć jego opis.
 * 8) **To może być na przykład dla samego oprogramowania wiki lub  dla zmian konfiguracyjnych na stronach wiki Wikimedia (zob. „”).
 * 9) * Subscribers: Powinieneś zignorować to pole: jeśli znasz konkretnych użytkowników, którzy mogliby być zainteresowani powiadomieniem o tym zadaniu, możesz dodać ich tutaj.
 * 1) ** W przypadku propozycji nowych funkcji:
 * 2) *** Opis tego, co chcesz osiągnąć i dlaczego. User story jest skutecznym sposobem na przekazanie tego.
 * Przykład:
 * 1) **Podaj też inne informacje, które mogą być przydatne, takie jak:
 * 2) ***przeglądarki internetowe, skórki lub systemy komputerowe, na których widać błąd;
 * 3) ***łącza lub odnośniki do wersji jednej lub więcej stron, na których wystąpił błąd; lub
 * 4) ***czy problem występuje za każdym razem, tylko od czasu do czasu, tylko na niektórych stronach, czy tylko w określonych okolicznościach.
 * 5) *Aby załączyć plik dziennika lub (upewnij się, że nie zawierają bądź przedstawiają one poufnych danych), naciśnij przycisk Wyślij plik (chmurka ze strzałką) w pasku narzędzi pola Opis.
 * 6) * Wybierz znaczniki (projektu/projektów) ze znalezionym błędem:
 * 7) **Projekty określają, jakich zadań poszukują twórcy do pracy. Aby zidentyfikować właściwy projekt, skorzystaj z funkcji wyszukiwania (w prawym górnym rogu), aby znaleźć jego opis.
 * 8) **To może być na przykład dla samego oprogramowania wiki lub  dla zmian konfiguracyjnych na stronach wiki Wikimedia (zob. „”).
 * 9) * Subscribers: Powinieneś zignorować to pole: jeśli znasz konkretnych użytkowników, którzy mogliby być zainteresowani powiadomieniem o tym zadaniu, możesz dodać ich tutaj.
 * 1) * Subscribers: Powinieneś zignorować to pole: jeśli znasz konkretnych użytkowników, którzy mogliby być zainteresowani powiadomieniem o tym zadaniu, możesz dodać ich tutaj.

Sprawdź, czy twoje zgłoszenie jest kompletne, po czym naciśnij przycisk Create New Task (Utwórz zadanie). Twoje zgłoszenie znajdzie się w bazie danych, dzięki czemu być może ktoś na nie wkrótce zareaguje.

Priorytet dla zadania ustawiany jest przez deweloperów, którzy planują pracę nad danym zadaniem (zob. Ustawianie priorytetów).

To wszystko! Dziękujemy za pomoc w udoskonalaniu MediaWiki oraz projektów Wikimedia!

Zgłaszanie błędu JavaScript

 * Zobacz również: Pomoc:Wyszukiwanie niedziałających skryptów

Jeśli napotkasz błąd, który może być związany z JavaScriptem, najlepiej zidentyfikuj komunikaty o błędach i skopiuj je do raportu.

Jest szczególnie ważne, aby dostarczyć wszystkie informacje, którymi dysponujesz, bo nawet administratorzy systemu nie będą mieli żadnego dostępu do rejestru błędów. Jeśli nie jesteś pewien czy dana funkcja, której używasz, jest oparta na JavaScript, spróbuj wyłączyć JavaScript.

Zawsze pomocne jest załączenie zrzut ekranu do zgłoszenia błędu. Często jest to najprostszy sposób na wskazanie, o jakiej funkcjonalności mówisz, a często może dostarczyć informacji, które mogą pomóc w zawężeniu problemu. Uważaj, aby ukryć wszelkie informacje, którymi nie chcesz się podzielić, podobnie jak otwarte karty przeglądarek lub zminimalizowanie okna czatu.

Zobacz też

 * Jak skutecznie zgłaszać błędy? autorstwa Simon Tatham
 * How to get the developer community to solve your problem, by User:MSchottlender-WMF, July 2017
 * Etykieta Phabricatora
 * Bug management/Bug report life cycle (ang.)
 * Pisanie dobrego raportu o błędzie lub prośby o funkcję (ang.)
 * Jak utworzyć dobry pierwszy raport o błędzie (przestarzały)
 * Wikipedia:Wnioski o błędach i propozycje nowych funkcji