Prispieť

Máte záujem o vylepšenie ghostwriter? Prečítajte si nižšie uvedené časti, aby ste zistili, ako môžete prispieť.

Hlásenia chýb

Našli ste chybu? Nahláste ju prosím v sledovači chýb KDE. Nezabudnite dodržiavať pokyny na hlásenie chýb! Najdôležitejšie je, aby ste nezabudli uviesť číslo verzie ghostwriter, ktorú používate.

Upozornenie: Ak neposkytnete informácie požadované v šablóne hlásenia chyby, hlásenie chyby bude automaticky uzavreté.

Triedenie chýb

Môžete pomôcť s triedením problémov v sledovači chýb reprodukovaním chýb a získavaním ďalších informácií od nahlasovateľov chýb, čo pomôže zúžiť miesto problému. Uzatváranie duplicitných problémov a iné upratovanie by bolo tiež vítané. Ďalšie informácie nájdete v pokynoch na triedenie chýb.

Nové funkcie a opravy chýb

Viete programovať? Postupujte podľa týchto krokov:

1. Nahláste problém pre vašu funkciu alebo chybu v sledovači chýb KDE.
   Poznámka: Tento krok je potrebný na zabezpečenie toho, že nová funkcia spĺňa ciele projektu alebo že chyba nie je v skutočnosti funkcia. Taktiež budete chcieť koordinovať, ktoré časti kódu budete aktualizovať, aby ste sa vyhli konfliktom pri zlučovaní v prípade, že na rovnakej časti kódu pracuje aj niekto iný.
2. Po diskusii o vašom novom probléme naprogramujte svoju funkciu alebo opravu chyby. Dodržiavajte prosím príručku štýlu kódovania KDE Frameworks. Dôležité: Prosím, udržiavajte svoj kód zameraný na daný problém. Nesúvisiace zmeny v kóde patria do samostatných problémov/žiadostí o zlúčenie, aby bola kontrola kódu a testovanie jednoduchšie.
3. Odošlite žiadosť o začlenenie (pull request) voči vetve master s vašimi aktualizáciami kódu.
   Dôležité: Pred odoslaním žiadosti o začlenenie prosím zlúčte (squash) svoje commity v gite!
4. Počkajte na stručnú kontrolu kódu a aspoň dvoch ďalších dobrovoľníkov, ktorí otestujú vašu funkciu alebo opravu chyby.
5. Aktualizujte svoju žiadosť o začlenenie podľa prijatej spätnej väzby.
6. Keď bude vaša žiadosť o začlenenie schválená aspoň dvoma ďalšími dobrovoľnými testermi, vaša žiadosť o začlenenie bude zlúčená.

Kontroly kódu

Viete programovať a máte zmysel pre detail? Prihláste sa ako dobrovoľník na kontrolu nových žiadostí o zlúčenie!

1. Vyhľadajte novú žiadosť o zlúčenie a pridajte komentár, že sa dobrovoľne prihlasujete na kontrolu kódu.
2. Odošlite komentáre ku kontrole kódu.
3. Počkajte na aktualizácie žiadosti o zlúčenie (ak je to potrebné).
4. Pokračujte v poskytovaní spätnej väzby, kým si nebudete istí, že kód je v poriadku.
5. Zanechajte komentár so schválením žiadosti o zlúčenie.
6. Keď aspoň dvaja dobrovoľní testeri odošlú svoje schválenie, žiadosť o zlúčenie bude zlúčená.

Tu sú niektoré tipy, na čo sa zamerať pri kontrolách kódu:

• Dodržiava odoslaný kód príručku štýlu kódovania KDE Frameworks?
• Je kód čitateľný, s komentármi vysvetľujúcimi neočividné riadky?
• Je kód "pesimistický"? Inými slovami, kontroluje neplatné hodnoty pred ich použitím a spracováva možné chybové stavy?
• Sú viaceré porovnania alebo výrazy zabalené v zátvorkách v príkazoch if na predchádzanie nehodám s poradím operácií? Príklady:

  // Zle
  if (a == b || c > d);
  
  // Správne
  if ((a == b) || (c > d));
  

• Sú literály na ľavej strane operátora ==, aby sa zabránilo tomu, že preklep s operátorom = unikne pozornosti kompilátora? Príklady:

  // Zle
  if (variable == 1);
  
  //         Dôvod: Čo ak je tam preklep? Kompilátor ho nezachytí!
  if (variable = 1); // Ups!
  // Správne
  if (1 == variable);
  
  //         Dôvod: Tentoraz kompilátor zachytí preklep.
  if (1 = variable); // Ups!
  

Testovanie

Prihláste sa ako dobrovoľník na kontrolu kódu a testovanie nových funkcií a opráv chýb! Postupujte podľa týchto krokov:

1. Vyhľadajte novú žiadosť o zlúčenie a pridajte komentár, že sa dobrovoľne prihlasujete na jej testovanie.
2. Zostavte žiadosť o zlúčenie na svojej platforme.
3. Otestujte funkciu/opravu chyby a pokúste sa ju rozbiť!
4. Poskytnite spätnú väzbu o výsledkoch testovania v žiadosti o zlúčenie.
5. Počkajte na aktualizácie žiadosti o zlúčenie (ak je to potrebné).
6. Pokračujte v testovaní a poskytovaní spätnej väzby, kým si nebudete istí, že kód funguje.
7. Zanechajte komentár so schválením žiadosti o zlúčenie.
8. Keď aspoň jeden ďalší dobrovoľný tester odošle svoje schválenie, žiadosť o zlúčenie bude prijatá.

Preklady

Zvážte prosím pripojenie sa k prekladateľskému tímu KDE a preložte svoje obľúbené aplikácie do iných jazykov.

Technická podpora

Vyznáte sa v Linuxe alebo zostavovaní pre MacOS? Viete, ako opraviť ten problém, na ktorý ostatní neustále narážajú? Vaše odpovedanie na otázky používateľov a riešenie problémov v sledovači chýb KDE by bolo veľmi oceňované!