Kako podnijeti izvješće o pogrešci? Follow
Proces razvoja softvera često je mukotrpan. Velike aplikacije mogu sadržavati milijune redaka koda koji moraju raditi na više platformi kao i uzeti u obzir gotovo beskonačan broj mogućih uvjeta u runtimeu. Posljedično, softver ove skale rijetko je savršen i možda se neće uvijek ponašati kako je predviđeno. We generally refer to flaws, errors, or otherwise unintended behavior as bugs.
Brave je novi, inovativni i ambiciozni projekt s mnogim pokretnim dijelovima. Iako je naš tim izuzetno talentiran i motiviran, vjerojatno ćete ponekad naići na pogreške dok pretražujete. Možete nam pomoći da nastavimo poboljšavati naš proizvod i pružimo bolje iskustvo pregledavanja tako što ćete nas upozoriti na pogreške na koje naiđete. Najbolji način za to je posjetiti našu zajednicu Brave i objaviti problem na koji nailazite kako bi ga naš tim za korisničku podršku i Brave tim mogli vidjeti.
Kako nastavljamo rasti, tako raste i broj zahtjeva za korisničkom podrškom koje primamo. Prije nego što objavite u zajednici, odvojite trenutak za sljedeće:
-
Pregledajte ovu bazu znanja
Izdana je kako bi se odgovorilo na mnoga uobičajena pitanja i poznate probleme. Iako je još u tijeku, sadržaj će se redovito dodavati i uvijek je vrijedno prvo provjeriti ovdje kako biste vidjeli je li vaš problem pokriven. -
Tražite duplikate
S obzirom na količinu izvješća/zahtjeva koje primamo svaki dan, velika je vjerojatnost da je netko već podnio vaš problem ili da je već riješen. Prije objave koristite traku za pretraživanje u gornjem desnom kutu web stranice kako biste vidjeli jesu li drugi korisnici podnijeli isti problem.
Kada objavljujete novu temu u zajednici, mogli biste primijetiti da je uređivač unaprijed popunjen nekim informacijama. Ono što vidite je predložak za prijavu pogrešaka koji smo umetnuli kako bismo prijavu zahtjeva za podršku i prijavu problema učinili što jednostavnijom.
Pročitajte upute na vrhu predloška i jednostavno unesite svoje informacije ispod odgovarajućeg dijela. Kada pravilno ispunite predložak, idealno će omogućiti članovima Brave tima sve što trebaju znati o problemu koji imate na brzinu i eliminira nepotrebne odgovore naprijed-natrag koji se koriste za razlučivanje nekih osnovnih informacija potrebnih za dijagnosticiranje problema. Također, naslov vaše objave treba biti sažet i informativan.
Kada je pravilno ispunjen, vaš izvještaj treba izgledati ovako:
Opis problema:
Brave neće otvoriti nijedan novi tab osim ako se ne otvori iz kontekstnog izbornika (izbornik desnim klikom).
Koraci za reprodukciju (dodajte koliko god je potrebno):
1. Pokrenite Brave
2. Posjetite bilo koju web stranicu, zatim pritisnite CTRL + T (ili CMD + T) za otvaranje novog taba
3. Ponavljajte za dodatne metode otvaranja tabova - klikom na + znak na traci s tabovima, iz glavnog izbornika, itd.
Stvarni rezultat (gifovi i snimke zaslona su dobrodošli!):
Novi tab nije otvoren
Očekivani rezultat:
Novi tab bi trebao biti otvoren
Koliko se često reproducira:
Uvijek
Brave verzija (pogledajte stranicu O Brave u glavnom izborniku):
Brave verzija - v0.60.0
Reproducible on current live release (yes/no):
Da
Dodatne informacije:
Koristim macOS Mojave v 10.1.14
Za korisnike koji su novi u prijavljivanju bugova i open source razvoju, izložio sam vrstu informacija koje treba uključiti prilikom popunjavanja svake sekcije predloška:
-
Opis problema
Iako može izgledati očigledno, ovaj deo će sadržati većinu vašeg izveštaja i nisu svi opisi korisni. Preporučujemo svima koji prijavljuju da pruže što više detalja o problemu.
Loš primjer opisa: "Neki videozapisi rade u Brave."
Dobar primer opisa: "YouTube videozapisi se neće reproducirati u Brave. Pokušavajući strimati, player ostaje crn i simbol za učitavanje se beskonačno vrti. Pokušavajući sa isključenim Štitovima, oglas pre videozapisa će se reproducirati, ali stvarni sadržaj nastavlja da se beskonačno učitava kada oglas završi."
-
Koraci za reprodukovanje
Često je korisno znati tačne korake koje ste preduzeli kada ste opisali problem. STR se razlikuje od opisa problema po tome što sadrži numerisani spisak jasno definisanih i lakih za praćenje radnji koje bi neko preduzeo i koji proizvode opisani problem.
Primer:
1. Pokreni Brave
2. Idi na YouTube
3. Pokušaj strimati video
4. Isključi Štitove i pokušaj ponovo strimati
-
Stvarni rezultat
Ovo je rezultat koji vidite nakon izvođenja gore navedenih koraka sa vaše strane. Gotovo kao skraćena verzija vašeg problema.
Primer: Sa uključenim Štitovima, player pokazuje ekran za učitavanje zauvek - sa isključenim Štitovima, oglas pre videozapisa se reproducira, a zatim se vraća na ekran za učitavanje zauvek.
-
Očekivani rezultat
Ovo je ono što vi (posebno) mislite da treba da se događa nakon izvođenja gore navedenih koraka.
Primer: Odabrani videozapis se strimuje.
-
Konstantno se reprodukuje?
Recite nam u jednoj ili dve reči koliko često se problem pojavljuje. Da li je to nešto što se događa svaki put ili je povremeno, i ako jeste, koliko je teško reproducirati/zabeležiti problem?
Primer: Svaki put
-
Brave verzija
Znanje o tome koju Brave build i verziju koristite može pomoći uvideti da li je problem nov, poznat ili prethodno poznat bug koji je rešen, ali se sada ponovo pojavljuje (regresija). Takođe potvrđuje da li vaš preglednik ima najnovija ažuriranja i popravke koje mogu biti uzrok buga. Možete pronaći vaše informacije o verziji i buildu tako što ćete iz glavnog menija odabrati About Brave.
Primer: Verzija 0.55.22 Chromium: 70.0.3538.77 (Official Build) (64-bit)
-
Dodatne informacije
Bilo koji dodatni detalji koje želite da dodate ili komentari koje želite da napravite nakon što su gore navedeni delovi popunjeni možete staviti ovde. Snimci ekrana ili video zapisi su takođe posebno vredni prilikom dijagnostikovanja problema, iako nisu obavezni. Ako odlučite da ih uključite u vaš izveštaj, ostavite ih ovde.
Molimo vas da pružite informacije u što više sekcija kako biste nam pomogli da rešimo ili zabeležimo vaš problem što efikasnije. Cijeli primjer problema korišten gore ima ukupno ~530 znakova (manje od dva Tweeta!).
BILJEŠKA: Bilo koji "Jednoredak", previše općeniti ili bug izvještaji/zahtjevi za podršku koji inače potpuno ignoriraju gore navedene smjernice neće biti odgovoreni. Ponavljano objavljivanje takvih članaka prouzrokuje da budete označeni ili zabranjeni.