How to report a bug/cs

Tyto pokyny vysvětlují jak napsat dobré hlášení chyby nebo žádost o novou funkci (úlohu) do systému nadace Wikimedie pro správu úloh (podrobnosti najdete na stránce ). Dobře napsané úlohy mají větší naději, že na nich bude někdo pracovat.



Rychlá doporučení

 * Buďte přesní.
 * Buďte srozumitelní: 1) vysvětlete, jak jde problém navodit, krok za krokem, bez ponechání prostoru pro vlastní interpretaci, 2) očekávané chování, 3) aktuální chování. A to samostatných sekcích.
 * U každého úkolu zahrňte pouze jednu konkrétní chybu nebo jeden konkrétní požadavek na funkci.
 * Dodejte jakékoliv potřebné odkazy a ukázky.



Než budete pokračovat


Dokážete problém zopakovat?
Zkuste hlášenou závadu zreprodukovat na aktuální verzi softwaru, abyste zjistili, zda již nebyla opravena. Pokud jste závadu nalezli na nějaké wiki, jako je Wikipedie, můžete nejnovější verzi vyzkoušet na test2.wikipedia.org.



Nenahlásil už tento problém někdo jiný?
Abyste zjistili, zda stejnou závadu už někdo nenahlásil, použijte vyhledávání v systému nadace Wikimedie pro správu chyb. Můžete také zkusit pokročilejší hledání na vyhledávací stránce.

Pokud si nejste jisti, zda stejnou závadu už někdo nenahlásil před vámi, radši ji nahlaste. Je lépe mít závady nahlášené dvakrát než nenahlášené vůbec.



Možné problémy s udělátkem nebo uživatelským skriptem?
Některé problémy jsou důsledkem používání uživatelských skriptů a udělátek, které vyžadují opravy. Tady je s kroky, jak identifikovat takový kód, který by mohl problém vyřešit. Abyste neztráceli čas jeho nahlášením.



Hlášení závady nebo žádosti o novou funkci
Pokud jste narazili na problém v aktuální verzi, který patrně dosud nikdo nenahlásil, tak:
 * 1) Jděte na phabricator.wikimedia.org.
 * 2) Pokud jste se dosud nepřihlásili, budete tak muset učinit nyní (nebo se zaregistrovat) (návod je na stránce "").
 * 3) Chcete-li ), klikněte na tlačítko Záložka (Bookmark) v pravém horním rohu a vyberte "Nahlásit chybu softwaru" (Report a Software Bug) (nebo "Nahlásit problém se zabezpečením" (Report a Security Issue).
 * 4) Vyplňte alespoň následující pole:
 * 5) * Title: Krátké shrnutí (pokud možno v jedné větě), které popisuje problém (nikoli navrhované řešení).
 * 6) ** Správně:
 * 7) ** Špatně:
 * 8) * Description: (popis) - úplné podrobnosti o problému, obsahující co nejvíce detailů. Ty by měly zahrnovat: Pokud to nestačí, budete požádáni o další informace spolu s návodem, jak je získat. Pole by mělo obsahovat:
 * 9) ** Pro závady:
 * 10) *** Postup pro zopakování: (Steps to Reproduce) - minimalizovaný, jednoduchý postup, který vyvolá popisovaný problém. Popište i případné zvláštní nastavení.
 * Příklad:
 * 1) *** Pozorované výsledky: (Actual Results) - co aplikace provedla po provedení výše uvedených kroků.
 * Příklad:
 * 1) *** Očekávané výsledky: (Expected Results) - co aplikace měla provést, kdyby v ní nebyla závada.
 * Příklad:
 * 1) ** Pro žádosti o nové funkce:
 * 2) *** Popis, čeho byste rádi dosáhli a proč. Vysvětlete, co doufáte, že funkce vyřeší (skutečný základní problém), spolu s konkrétními příklady. Nemusíte navrhovat konkrétní řešení, protože mohou existovat jiná třeba i lepší řešení. Příběh uživatele (jak se k problému dostal) je efektivní způsob, jak sdělit požadované řešení.
 * Příklad:
 * 1) ** Poskytněte prosím všechny další informace, které by mohly být užitečné, jako například:
 * 2) *** Webové prohlížeče, zobrazení nebo počítačové systémy, na kterých jste chybu viděli.
 * 3) *** Odkazy nebo srovnání stránky nebo stránek, na kterých jste na závadu narazili nebo
 * 4) *** Zda se problém objevuje pokaždé, jen někdy, jen na některých stránkách nebo jen za zvláštních okolností.
 * 5) * K hlášení můžete připojit soubor s logy nebo (ale ujistěte se, že neobsahuje žádné tajné či soukromé údaje). Abyste tak učinili, použijte tlačítko Upload File (nahrát soubor - vypadá jako mrak se šipkou) v nástrojové liště pole Description.
 * 6) * Vyberte jeden nebo více projektů (tags), kterých se závada týká:
 * 7) ** Projekty jsou způsob, kterým vývojáři spravují své úkoly a hledají ty, kterým by se měli věnovat. K určení správných projektů použijte vyhledávací funkci (dostupná vpravo nahoře).
 * 8) ** Vhodný je projekt pro software, na kterém wiki běží, nebo  pro změny konfigurace na serverech Wikimedie (podívejte se na stránku ).
 * 9) * Subscribers: (odběratelé): Pokud víte o někom, koho by zajímal průběh práce na daném úkolu, přidejte ho sem. Jinak toto pole ignorujte.
 * 1) *** Webové prohlížeče, zobrazení nebo počítačové systémy, na kterých jste chybu viděli.
 * 2) *** Odkazy nebo srovnání stránky nebo stránek, na kterých jste na závadu narazili nebo
 * 3) *** Zda se problém objevuje pokaždé, jen někdy, jen na některých stránkách nebo jen za zvláštních okolností.
 * 4) * K hlášení můžete připojit soubor s logy nebo (ale ujistěte se, že neobsahuje žádné tajné či soukromé údaje). Abyste tak učinili, použijte tlačítko Upload File (nahrát soubor - vypadá jako mrak se šipkou) v nástrojové liště pole Description.
 * 5) * Vyberte jeden nebo více projektů (tags), kterých se závada týká:
 * 6) ** Projekty jsou způsob, kterým vývojáři spravují své úkoly a hledají ty, kterým by se měli věnovat. K určení správných projektů použijte vyhledávací funkci (dostupná vpravo nahoře).
 * 7) ** Vhodný je projekt pro software, na kterém wiki běží, nebo  pro změny konfigurace na serverech Wikimedie (podívejte se na stránku ).
 * 8) * Subscribers: (odběratelé): Pokud víte o někom, koho by zajímal průběh práce na daném úkolu, přidejte ho sem. Jinak toto pole ignorujte.

Zkontrolujte, zda je hlášení úplné, a klikněte na tlačítko „Create Task“. Vaše hlášení nyní bude uloženo v databázi. To umožní někomu, kdo bude mít zájem, aby se na hlášení podíval a případně na něm.

Stupeň priority úlohy bude nastaven vývojáři, kteří se rozhodnou na ní pracovat (viz Nastavení priority).

To je vše! Děkujeme za vaši pomoc při vylepšování MediaWiki a projektů Wikimedie!



Nahlášení závady v JavaScriptu

 * Víc vám poví: 

Mnoho funkcí, jako jsou udělátka (gadgets), uživatelské skripty a některé části MediaWiki, se spoléhají na JavaScript.

Pokud narazíte na závadu, která může souviset s JavaScriptem, udělejte maximum, abyste identifikovali chybové zprávy, a zkopírujte je do zprávy o závadě.

Je obzvláště důležité poskytnout všechny informace, které máte, protože i správci systému budou mít nulový přístup k jakémukoli protokolu závad.

Pokud je problém v kódu uživatelského skriptu nebo samotného udělátka, nemusí být Phabricator místem, kde bude problém vyřešen. Můžete být přesměrováni na diskusní stránku ke skriptu (pokud je problémový skript identifikován).



Nahlášení problému s připojením
Pokud máte problémy se vůbec připojit k některé ze stránek projektu Wikimedie (příliš pomalý internet apod.), pokračujte na stránku https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue (v angličtině).



Nahlášení problému s přihlašováním
Pokud máte problémy s přihlášením ke svému účtu, pokračujte na.

Poznámky


Související stránky

 * Simon Tatham: Jak správně hlásit závady
 * Jak přimět vývojářskou komunitu k vyřešení Vašeho problému, User:MSchottlender-WMF, červenec 2017
 * Wikimedie Phabricator
 * Jak napsat dobré hlášení závady nebo dobrý požadavek na novou funkci
 * Jak napsat dobré první hlášení závady (zastaralé)
 * Hlášení chyb a požadavky na funkce na anglické Wikipedii
 * Jak napsat dobré první hlášení závady (zastaralé)
 * Hlášení chyb a požadavky na funkce na anglické Wikipedii