Jak zgłosić raport o bugu? Obserwuj
Proces tworzenia oprogramowania jest często żmudny. Duże aplikacje mogą zawierać miliony linii kodu, które muszą działać na różnych platformach oraz uwzględniać niemal nieskończoną liczbę możliwych warunków w czasie działania. W związku z tym oprogramowanie na taką skalę jest rzadko doskonałe i może nie zawsze zachowywać się zgodnie z oczekiwaniami. We generally refer to flaws, errors, or otherwise unintended behavior as bugs.
Brave to nowy, innowacyjny i ambitny projekt z wieloma ruchomymi częściami. Chociaż nasz zespół jest niezwykle utalentowany i zmotywowany, prawdopodobnie natkniesz się czasami na błędy podczas przeglądania. Możesz pomóc nam ciągle udoskonalać nasz produkt i dostarczać lepsze doświadczenia przeglądania, zgłaszając nam napotkane błędy. Najlepszym sposobem na to jest odwiedzenie naszej strony społeczności i zamieszczenie zgłoszenia problemu, aby zobaczyli je nasz dział wsparcia i zespół Brave.
W miarę jak rośniemy, rośnie również liczba zgłoszeń do wsparcia, które otrzymujemy. Zanim zamieścisz zgłoszenie w społeczności, poświęć chwilę, aby wykonać następujące kroki:
-
Przejrzyj tę bazę wiedzy
Jest ona zbudowana, aby odpowiedzieć na wiele powszechnych pytań i znanych problemów. Chociaż jest to nadal praca w toku, treści będą regularnie dodawane i zawsze warto najpierw sprawdzić tutaj, czy Twój problem jest objęty. -
Szukaj Duplikatów
Biorąc pod uwagę liczbę zgłoszeń/żądań, które dostajemy każdego dnia, istnieje duża szansa, że ktoś inny już zgłosił Twój problem lub że został on już rozwiązany. Przed zamieszczeniem, użyj paska wyszukiwania w prawym górnym rogu strony, aby sprawdzić, czy inni użytkownicy zgłosili to samo zagadnienie.
Podczas zamieszczania nowego tematu w społeczności, możesz zauważyć, że edytor jest wstępnie wypełniony pewnymi informacjami. To, co widzisz, to szablon zgłoszenia błędu, który wstawiliśmy, aby uczynić zgłaszanie żądań wsparcia i zgłaszanie problemów tak prostym, jak to możliwe.
Przeczytaj instrukcje na górze szablonu i po prostu wstaw swoje informacje pod odpowiednią sekcję. Kiedy szablon zostanie poprawnie wypełniony, powiadomi on członków zespołu Brave o wszystkim, co muszą wiedzieć na temat problemu, który masz, na pierwszy rzut oka i eliminuje niepotrzebne odpowiedzi tam i z powrotem używane do uzyskania podstawowych informacji potrzebnych do zdiagnozowania problemu. Dodatkowo, tytuł Twojego zgłoszenia powinien być zwięzły i informacyjny.
Kiedy zostanie poprawnie wypełnione, Twoje zgłoszenie powinno wyglądać mniej więcej tak:
Opis problemu:
Brave nie otwiera nowych kart z wyjątkiem tych otwieranych z menu kontekstowego (menu prawego przycisku myszy).
Kroki do odtworzenia (dodaj tyle, ile to konieczne):
1. Uruchom Brave
2. Odwiedź dowolną stronę internetową, a następnie naciśnij CTRL + T (lub CMD + T), aby otworzyć nową kartę
3. Powtórz, aby sprawdzić inne sposoby otwierania kart - klikając na znak + na pasku kart, z menu głównego, itp.
Faktyczny wynik (gify i zrzuty ekranu są mile widziane!):
Nowa karta nie zostaje otwarta
Oczekiwany wynik:
Nowa karta powinna zostać otwarta
Jak często można to odtworzyć:
Zawsze
Wersja Brave (Sprawdź stronę O Brave w menu głównym):
Wydanie Brave - v0.60.0
Czy można odtworzyć na bieżącej wersji (tak/nie):
Tak
Dodatkowe informacje:
Używam macOS Mojave v 10.1.14
Dla użytkowników, którzy dopiero zaczynają zgłaszać błędy i rozwijać open source, przygotowałem listę informacji, jakie należy podać wypełniając każdą sekcję szablonu:
-
Opis problemu
Może się wydawać oczywiste, ale ta sekcja będzie stanowić główną część zgłoszenia i nie wszystkie opisy są użyteczne. Zachęcamy wszystkich zgłaszających do podania jak najwięcej szczegółów na temat problemu.
Zły przykład opisu: "Niektóre filmy działają w Brave."
Dobry przykład opisu: "Filmy na YouTube nie odtwarzają się w Brave. Podczas próby odtwarzania streamu odtwarzacz pozostaje czarny, a symbol ładowania obraca się bez końca. Kiedy próbuję z wyłączonymi Tarczami, reklama przed filmem odtwarza się, ale właściwa zawartość nadal ładuje się bez końca po zakończeniu reklamy."
-
Kroki do odtworzenia
Często przydatne jest poznanie dokładnych kroków, które wywołują zachowanie opisane w opisie problemu. STR różni się od opisu problemu, ponieważ składa się z numerowanej listy jasno zdefiniowanych i łatwych do naśladowania działań, które należy wykonać, aby wystąpił opisany problem.
Przykład:
1. Uruchom Brave
2. Przejdź na YouTube
3. Spróbuj odtworzyć film
4. Wyłącz Tarcze i spróbuj odtworzyć ponownie
-
Rzeczywisty wynik
To wynik, który widzisz po wykonaniu powyższych kroków. Prawie jak krótka wersja twojego problemu.
Przykład: Z włączonymi Tarczami odtwarzacz filmów pokazuje ekran ładowania na zawsze - z wyłączonymi tarczami, reklama przed filmem odtwarza się, a następnie powraca do ekranu ładowania na zawsze.
-
Oczekiwany wynik
To, co ty (specyficznie) uważasz, że powinno się dziać po wykonaniu powyższych kroków.
Przykład: Wybrany film jest odtwarzany.
-
Czy problem powtarza się konsekwentnie?
Powiedz w dwóch słowach, jak często występuje problem. Czy jest to coś, co dzieje się za każdym razem, czy jest to sporadyczne i jeśli tak, jak trudno jest wywołać/uchwycić problem?
Przykład: Za każdym razem
-
Wersja Brave
Znajomość tego, jaki build Brave i numer wersji, której używasz, może pomóc sprawdzić, czy problem jest nowy, znany lub wcześniej znany błąd, który był już rozwiązany, ale teraz pojawia się ponownie (regresja). Umożliwia to również sprawdzenie, czy twoja przeglądarka ma najnowsze aktualizacje i poprawki, które mogą być przyczyną błędu. Możesz znaleźć informacje o swojej wersji i buildzie, wybierając Informacje o Brave z głównego menu.
Przykład: Wersja 0.55.22 Chromium: 70.0.3538.77 (Oficjalny build) (64-bitowy)
-
Dodatkowe informacje
Wszelkie dodatkowe szczegóły, które chciałbyś dodać lub komentarze po wypełnieniu powyższych sekcji, możesz umieścić tutaj. Zrzuty ekranu lub nagrania ekranu są również szczególnie cenne podczas diagnozowania problemu, choć nie są one obowiązkowe. Jeśli zdecydujesz się je dołączyć do zgłoszenia, umieść je tutaj.
Proszę podaj informacje w jak największej liczbie sekcji, aby pomóc nam rozwiązać lub zarejestrować twój problem tak szybko, jak to możliwe. Całość przykładowego problemu użytego powyżej to ~530 znaków (mniej niż dwa Tweety!).
UWAGA: Każdy"jeden liniowy", zbyt ogólny, lub zgłoszenia błędów/wnioski o wsparcie, które całkowicie ignorują powyższe wytyczne, nie będą odpowiadane. Powtarzające się publikowanie takich artykułów spowoduje oznaczenie lub zbanowanie.