Hlášení chyb a námětů
Vývojáři GNOME potřebují odezvu od uživatelů, aby věděli, že to, co dělají, dělají správně – nebo naopak špatně. Jednou z možností předání odezvy vývojářům je GNOME Bugzilla – o té pojednává tento dokument.
Narazíme-li na chybu v aplikaci, je třeba na ni upozornit vývojáře. Je velmi důležité na chyby upozorňovat, protože chyba se může projevovat jen na našem počítači při nějakém velmi speciálním nastavení a dokud o problému někomu neřekneme, nikdo o něm neví – a tedy ho nebude ani řešit.
GNOME Bugzilla je webová stránka, na které se shromažďuje veškerá odezva týkající se technického hlediska GNOME. Uživatelé do ní mohou nahlásit, že nějaká aplikace pracuje chybně, nebo mohou vývojářům třeba jen sdělit, jakou novou funkci by si v nějaké aplikaci přáli.
Do GNOME Bugzilly může přispět každý. Je potřeba jen umět trochu anglicky, protože v GNOME Bugzille se komunikuje výhradně anglicky. Není třeba umět perfektně: stačí taková úroveň jazyka, aby vám vývojáři porozuměli.
Než si povíme něco podrobnějšího, je nutné vysvětlit některé pojmy související s GNOME Bugzillou:
- chyba (anglicky bug) – chybami jsou všechny záznamy v GNOME Bugzille; nemusí se jednat pouze o špatnou funkčnost aplikací, ale může se jednat například i o žádost o funkci
- žádost o funkci (anglicky feature request) – podtyp chyby; uživatel žádá o to, aby do aplikace byla zařazena nějaká nová funkce či vlastnost
- hlásit chybu (anglicky report a bug) – proces ukládání záznamu o chybě do GNOME Bugzilly
- záplata (anglicky patch) – vývojářem vyprodukovaná oprava zdrojového kódu
Postup při hlášení chyby
Na následujících řádcích je velmi zhruba uveden postup, kterého by se uživatel měl držet, chce-li hlásit chyby do GNOME Bugzilly.
- Předpříprava. Ještě před samotným vstupem do GNOME Bugzilly je třeba si přesně rozmyslet, co chceme: jestli chceme nahlásit, že aplikace funguje špatně (například padá, dává neočekávané výsledky atd.), nebo jestli chceme požádat o zařazení nové funkce do aplikace. Také je potřeba vědět, jaké aplikace se naše hlášení týká.
- Přesvědčení se o neduplicitnosti. Než nahlásíme chybu, měli bychom se přesvědčit, že to už neudělal někdo jiný – jinak by vznikala duplicitní hlášení. Je tedy nutné si prohlédnout existující záznamy u konkrétní aplikace. To se provede výběrem položky Browse z menu a pak výběrem aplikace. Vůbec není třeba si pročítat každý záznam! Stačí, když se alespoň zhruba podíváme. Musíme se podívat tím pečlivěji, čím se naše hlášení zdá běžnější – chceme-li například žádat o nějakou velmi exotickou funkci, stačí si záznamy jen velmi zběžně prolétnout.
- Samotné hlášení. Hlášení se provádí pomocí průvodce, který se nás ptá na důležité okolnosti: na typ hlášení, na komponentu aplikace, na prioritu, ale i další věci.
- Popis chyby. Chybu je třeba co nejlépe popsat. Nestačí napsat jen to, že aplikace „padá“ – důležité jsou i okolnosti, v tomto případě například popis toho, co jsme dělali, když aplikace spadla. Čím je popis podrobnější, tím je lepší. Na druhou stranu není třeba psát do GNOME Bugzilly celé romány, nejlepší je psát věcně a stroze. Pokud žádáme o nějakou funkci, dobré je napsat také to, proč ji potřebujeme.
Co se děje po nahlášení chyby
Nahlášením chyby naše činnost nemusí končit; záznam s chybou má svůj další vývoj:
- Potvrzení chyby. Každá nově nahlášená chyba je tzv. nepotvrzená (unconfirmed). Až kompetentní vývojář může její stav změnit, například ji označit za novou (a tedy potvrzenou – takovou, která se bude řešit). Také ji ale může označit například za neplatnou nebo duplicitní – tyto chyby se neopravují.
- Vyžádání dalších informací. Může se stát, že informace, keré jsme o chybě poskytli, nejsou pro vývojáře dostatečné. Nemusí to znamenat, že jsme chybu špatně popsali; vývojář prostě může potřebovat nějakou velmi speciální informaci. V takovém případě mu dodáváme prostřednictvím komentářů vše potřebné, přičemž ke komentářům lze přikládat i soubory (například obrázky – třeba snímky obrazovky s chybně se chovající aplikací atd.).
- Vyřešení chyby. Je-li chyba opravena, je označena za vyřešenou (fixed). Oprava se může projevit v další hlavní verzi GNOME (týká se to hlavně žádostí o funkce) nebo i v opravných verzích (týká se hlavně chybné funkčnosti). K chybě může být přiložena také záplata.