Jak nahlásit chybu v aplikaci Gaphor

Pokud jste někdy napsali řádek kódu, víte, že každý software má chyby. Stejně tomu bude i v případě aplikace Gaphor. Pokud si myslíte, že jste našli chybu, jednoduše klikněte na odkaz níže (musíte mít účet na GitHubu) a poté klikněte na zelené tlačítko “New Issue”, které najdete v pravém horním rohu stránky:

Report a Bug in Gaphor

Při vytvoření nového problému mu bude přiděleno číslo a dobrovolní vývojáři, kteří píší a udržují kód, budou informováni e-mailem. Ti mohou k vašemu problému připojit poznámky, pokud vám něco není jasné. Mohou jej okamžitě uzavřít a označit jako “duplicitní” (chybu již nahlásil někdo jiný - a odkáží na původní problém). Někdy chybu uzavřou a řeknou “nebude se opravovat”, protože nesouhlasí s tím, že jde o chybu nebo je příliš triviální, aby do ní investovali čas.

Obecně existují dva druhy chyb:

  • Technická: v kódu je chyba, která způsobí přerušení programu.
  • Chování: kód funguje správně, ale dělá špatnou věc.

V obou případech, abychom mohli chybu opravit, potřebujeme co nejvíce informací. Při vytváření nového problému byste se měli pokusit uvést, pokud je to relevantní, následující druhy informací:

  • O co jste se snažili,
  • Jaké kroky jste podnikli, aby se tak stalo,
  • Co jste očekávali, že se stane,
  • Co se vlastně stalo,
  • Proč je tento rozdíl problematický (nemusí to být chyba!),
  • Technické údaje, jako je verze programu Gaphor, kterou používáte, verze operačního systému a další aspekty kontextu, ve kterém byl program Gaphor spuštěn.

Problém popište jednoduchým a srozumitelným jazykem, a pokud je to užitečné, rozdělte jej do jednotlivých kroků, aby vývojáři mohli problém snadno znovu vytvořit. Nepředpokládejte, že pochopíme, čeho jste se snažili dosáhnout - upřímně řečeno, nejlepší bude, když si zkusíte představit, že my (vývojáři) jsme banda chytrých pětiletých dětí. Pokuste se vysvětlit vše o problému a nepředpokládejte, že víme, co máte na mysli. Nebude nám to vadit!

If you would like to get more involved in the development of Gaphor, we’d love to welcome you via the Gaphor developer’s website.