Přispět

Chcete pomoci vylepšit ghostwriter? Přečtěte si prosím následující oddíly, kde se dozvíte, jak můžete přispět.

Hlášení chyb

Našli jste chybu? Nahlaste ji prosím v systému pro sledování chyb KDE. Nezapomeňte dodržovat pokyny pro hlášení chyb! A co je nejdůležitější, nezapomeňte uvést číslo verze programu ghostwriter, který používáte.

Upozornění: Pokud v šabloně hlášení chyby neuvedete požadované informace, bude hlášení chyby automaticky uzavřeno.

Třídění chyb

Můžete pomoci s tříděním hlášení v systému sledování chyb tím, že chyby zreprodukujete a získáte od autorů hlášení další informace, které pomohou zúžit okruh možných příčin problému. Uvítáme také uzavírání duplicitních hlášení a další úklid. Další informace najdete v pokynech pro třídění chyb.

Nové funkce a opravy chyb

Umíte programovat? Postupujte podle těchto kroků:

1. Zadejte požadavek týkající se vaší nové funkce nebo chyby v systému pro sledování chyb KDE.
   Poznámka: Tento krok je nezbytný k zajištění toho, aby nová funkce odpovídala cílům projektu nebo aby se nejednalo o chybu, která je ve skutečnosti funkcí. Měli byste se také domluvit, které části kódu budete upravovat, abyste předešli konfliktům při slučování, pokud by na téže části kódu pracoval i někdo jiný.
2. Po projednání vašeho nového úkolu naprogramujte danou funkci nebo opravu chyby. Dodržujte prosím Průvodce stylem kódování KDE Frameworks. Důležité: Prosím, zaměřte svůj kód výhradně na daný úkol. Nesouvisející změny v kódu by měly být předmětem samostatných úkolů/žádostí o sloučení, aby se usnadnila revize kódu a testování.
3. Odešlete pull request do větve master s vašimi aktualizacemi kódu.
   Důležité: Před odesláním pull requestu prosím v Git-u slučte své commity!
4. Počkejte, až proběhne krátká revize kódu a až vaši funkci nebo opravu chyby otestují alespoň dva další dobrovolníci.
5. Na základě obdržené zpětné vazby aktualizujte svůj pull request.
6. Jakmile váš pull request schválí alespoň dva další dobrovolní testeři, bude váš pull request sloučen.

Revize kódu

Umíte programovat a máte smysl pro detail? Přihlaste se jako dobrovolník k vzájemnému posuzování nových žádostí o sloučení!

1. Najděte novou žádost o sloučení a přidejte komentář, že se dobrovolně hlásíte k její revizi kódu.
2. Odešlete připomínky k revizi kódu.
3. Počkejte na aktualizace žádosti o sloučení (je-li to nutné).
4. Pokračujte v poskytování zpětné vazby, dokud nebudete mít jistotu, že je kód v pořádku.
5. Zanechte komentář, ve kterém vyjádříte svůj souhlas s žádostí o sloučení.
6. Jakmile alespoň dva dobrovolní testeři vyjádří svůj souhlas, bude žádost o sloučení schválena.

Zde je několik tipů, na co se při revizích kódu zaměřit:

• Odpovídá zaslaný kód příručce pro styl kódování KDE Frameworks?
• Je kód srozumitelný a obsahují komentáře vysvětlení všech nejasných řádků?
• Je tento kód "pesimistický"? Jinými slovy, prověřuje neplatné hodnoty před jejich použitím a zpracovává případné chybové stavy?
• Jsou vícenásobná srovnání nebo výrazy v závorkách uvnitř příkazů if za účelem zabránění omylům v pořadí operací? Příklady:

  // Špatně
  if (a == b || c > d);
  
  // Správně
  if ((a == b) || (c > d));
  

• Zabrání-li přítomnost výrazů na levé straně operátoru == tomu, aby kompilátoru unikla překlepová chyba způsobená záměnou s operátorem =? Příklady:

  // Špatně
  if (variable == 1);
  
  //         Důvod: Co když se tam objeví překlep? Kompilátor to nezachytí!
  if (variable = 1); // Jejda!
  // Správně
  if (1 == variable);
  
  //         Důvod: Tentokrát kompilátor tuto překlepovou chybu odhalí.
  if (1 = variable); // Jejda!
  

Testování

Zapojte se jako dobrovolník do revize kódu a testování nových funkcí a oprav chyb! Postupujte podle následujících kroků:

1. Vyhledejte novou žádost o sloučení a přidejte komentář, že se dobrovolně hlásíte k jejímu otestování.
2. Vytvořte žádost o sloučení na své platformě.
3. Otestujte tuto funkci/opravu chyby a zkuste ji rozbít!
4. V žádosti o sloučení uveďte zpětnou vazbu k výsledkům testů.
5. Počkejte na aktualizace žádosti o sloučení (je-li to nutné).
6. Pokračujte v testování a poskytování zpětné vazby, dokud nebudete mít jistotu, že kód funguje.
7. Zanechte komentář, ve kterém vyjádříte svůj souhlas s žádostí o sloučení.
8. Jakmile alespoň jeden další dobrovolný tester vyjádří svůj souhlas, bude žádost o sloučení přijata.

Překlady

Zvažte prosím připojení se k překladatelskému týmu KDE a pomozte překládat své oblíbené aplikace do jiných jazyků.

Technická podpora

Vyznáte se v Linuxu nebo ve vývoji pro macOS? Víte, jak vyřešit ten konkrétní problém, na který ostatní neustále narážejí? Velmi bychom ocenili, kdybyste odpovídali na dotazy uživatelů a pomáhali řešit problémy v systému sledování chyb KDE!