The free and open productivity suite

Jak na Issuezillu

Stručný návod jak si zřídit v Issuezille účet, naučit se komentovat existující chyby a zakládat nové.

Obsah:

• Vytvoření a nastavení účtu
• Přihlašování a odhlašování
• Prohlížení chyb, přidávání komentářů
• Zakládáme nový problém
• Sledování vlastních Issue

Vytvoření a nastavení účtu

Vytvořit si účet v systému IssueZilla je velmi jednoduché. Navštivte stránku cs.openoffice.org a vpravo nahoře vyberte "Register".

Nyní musíte zadat název svého účtu (login) a svou e-mailovou adresu a potvrdit tlačítkem Register. Pokud již účet s daným jménem existuje, budete si muset vybrat jiné.

Pokud uspějete, bude vám na vaši e-mailovou adresu poslán email s odkazem na stránku, kde si nastavíte heslo.

Po nastavení hesla se dostanete na hlavní stránku vašeho účtu (je též dostupná z My pages z odkazu "My start page" v levém menu).

Chceme-li změnit heslo, případně e-mailovou adresu, použijeme v levém menu odkaz "My profile" a dostaneme se na stránku s definicí profilu.

Nyní máte zřízen účet, pomocí kterého můžete do Issuezilly přispívat.

Přihlašování a odhlašování

Pokud již máte vytvořen účet na OpenOffice.org, můžete se přihlásit. Navštivte stránku cs.openoffice.org a vpravo nahoře vyplňte jméno, heslo a klikněte na "Login".

Pokud jste zapomněli heslo, tak na stránce cs.openoffice.org klepněte na odkaz "My pages" a pak zadejte login a nechte si na vaši e-mailovou adresu poslat nové heslo (stiskem tlačítka "New password").

Chcete-li se odhlásit použijte vpravo nahoře odkaz "Logout" .

Prohlížení chyb, přidávání komentářů

Vyhledávač chyb je bez přihlášení dostupný k prohlížení (!) ze stránky cs.openoffice.org přes odkaz "Issuezilla" v pravém menu.

Pro práci s vyhledávačem chyb je třeba se přihlásit a pak použít odkaz "My issues" v levém menu na hlavní stránce.

Vyhledávač chyb - to je Issue tracking query:

Jak se s ním zachází?

Každou chybu můžeme najít podle jejího čísla (ID), které ji jednoznačně identifikuje - stačí vpravo nahoře vyplnit číslo a provést "Jump to issue". Pokud ale číslo chyby neznáme (nebo si ho nepamatujeme) použijeme vyhledávání podle kritérií z nichž pro nás nejdůležitější jsou:

• Issue type:
  • DEFECT - chyba, zvoleno implicitně
  • ENHANCEMENT - vylepšení, tj. nejedná se o chybu, ale o návrh na zlepšení
  • FEATURE - vlastnost, pokud se jedná o úplně novou vlastnost
  • TASK - úkol, pokud se jedná o to pouze něco udělat - např. zveřejnit build apod.
  • PATCH - k chybě je připojen patch zdrojových kódů, který chybu odstraní
• Component - komponenta OpenOffice.org, které se problém týká - pokud se problém týká české lokalizace, bude zde vždy cs.
• Subcomponent - konkrétnější zařazení, které části aplikace se problém týká:
• helpcontent - chyba v nápovědě
• translation - chyba v překladech textů dialogů aplikace (nabídka, popisky tlačítek apod.)
• www - chyba souvisí s webem cs.openoffice.org
• code - chyba ve vlastním programu (chyby typu "aplikace spadne, když udělám XY", nebo "při exportu do Wordu mi nefunguje XY").
• Status - status (stav) chyby - nová / otevřená (started) / znovuotevřená (reopened) / uzavřená / vyřešená
• Platform - na jaké platformě byl problém pozorován (obvykle PC, ale např. i Macitosh či Palm PDA)
• OS - na jakém operačním systému byl problém pozorován (Windows 2000, Linux, FreeBSD apod.)
• Version - ve které verzi OOo byl problém pozorován (OOo 1.1beta2, OOo 1.1RC2 apod.)
• Target milestone - jedná se o verzi, kdy bude chyba vyřešena. Target milestone nastavuje / mění vývojář, který za problém zodpovídá, podle důležitosti chyby, časového zaneprázdnění apod.

V našem případě budeme hledat všechny "cs" chyby a proto zvolíme Component = cs a dáme "Submit query".

V tabulce vidíme čtyři chyby u nichž je uvedeno: ID, typ, priorita, vlastník, status, řešení a název: "Summary", což nám umožní efektivně vyhledávat. Pokud bychom chtěli změnit zobrazení sloupců klikneme na odkaz "Change columns". Kliknutím na ID chyby si zobrazíme její report - v našem případě to bude issue 22385.

V horní části jsou uvedeny všechny parametry chyby, pod nimi najdeme to nejdůležitější: Description vlastní popis chyby a případné komentáře uživatelů a vývojářů. Jako první najdete původní report problému. Pak obvykle následují reakce vývojářů, případné žádosti na dodání více informací, screenshotů, problematických souborů apod. Mezi tím jsou komentáře uživatelů snažících se pomoci a doplnit potřebné informace. U každého komentáře je poznamenáno kdo a kdy jej napsal.

Jestliže chcete k chybě přidat svůj komentář napište jej do pole "Additional Comments".

Vítáno je zejména:

• potvrzení chyby - např. byla nahlášena chyba XY pozorovaná ve verzi OOo1.1beta2 pod Linuxem RedHat 8.2. Vy si chybu vyzkoušíte a připojíte svou poznámku, že u OOo1.1beta2 pod Windows2000 tuto chybu pozorujete rovněž.
• upřesnění chyby - např. byla nahlášena chyba XY, kdy při exportu dokumentu do Wordu je poškozena čeština. Vy si chybu vyzkoušíte a všimnete si, že k problému dochází pouze, pokud je text ve fontu XYZ.

Když vás průběh řešení chyby zajímá nebo jen prostě chcete pomoci připište se do Add CC: - nebudete se tak muset do Issuezilly vracet jen abyste zkontrolovali, zda vývojáři nějak pokročili, ale každý další komentář k této chybě vám automaticky přijde e-mailem. Vývojáři jsou tak s vámi stále v kontaktu. Pokud vás problém časem přestane zajímat, není problém se ze seznamu CC: opět odstranit. Do CC: napište svůj login, systém použije e-mailovou adresu, kterou jste uvedli v nastavení svého účtu. Pokud někdy změníte svoji e-mailovou adresu, stačí ji změnit jen jednou v nastavení vašeho účtu a není již nutné procházet jednotlivé záznamy v Issuezille.

Zakládáme nový problém

Přihlaste se na cs.openoffice.org a přejděte do Issue tracking query a klepněte na odkaz "New".

Budete vyzváni k volbě komponenty, které se problém týká.

Týká-li se problém české lokalizace zvolíme "cs" a přejdeme do okna zadání reportu o chybě.

Vyplníme formulář - verzi (ve které se chyba vyskytuje), subkomponentu, platformu atd., do CC: zapíšeme login pro zasílání notifikací (použije se emailová adresa z nastavení účtu), zadáme název a problém popíšeme. Jsme li hotovi zvolíme "Submit issue" čímž report odešleme.

Objeví se dialog o odeslání reportu. Zde je důležitý odkaz pro připojení souboru k reportu.

Zde můžeme vložit soubor, přičemž zvolíme jeho typ a pak dáme "submit".

Sledování vlastních Issue

Pokud jste do systému již zadali nějaké Issue pak jej sledujete prostřednictvím automaticky generovaných emailů, navíc pokud se přihlásíte na cs.openoffice.org a přejdete na issue tracking query tak se vám defaultně zobrazí právě vaše issue - musí být ovšem v řešení - tj. status new / started / reopened.

Pokud se změní status issue - tj. vývojáři na něm zapracovali a je opraveno (o čemž jste informováni emailem), tak ho nejrychleji naleznete pomocí čísla. Ověřte zda v nových buildech (podle target milestone) je chyba opravena a podejte o tom zprávu, přičemž nezapomeňte změnit status - "VERIFIED" pokud je chyba opravena (nezapomeňte uvést verzi a build + identifikaci systému) anebo "REOPENED" pokud se chyba stále vyskytuje (opět uveďte verzi a build + identifikaci systému)

Tak to je v podstatě vše důležité. Nyní byste již měli umět nejen přidávat komentáře k existujícím záznamům o problémech v Issuezille, ale i vytvářet nové.