Prispevajte

Vas zanima narediti ghostwriter še boljši? Preberite razdelke spodaj, da vidite, kako lahko prav vi prispevate k temu.

Poročila o hroščih

Sta našli programsko napako? Poročajte o njej na sledilnik KDE issue tracker. Ne pozabite slediti smernicam poročanja issue reporting guidelines! In najpomembnejše, ne pozabite vnesti številko različice aplikacije ghostwriter, ki jo uporabljate.

Opozorilo: Neuspešno zagotavljanje informacij, ki s so obvezne v predlogi poročila o napakah bo povzročila samodejno zaprtje poročila.

Triaža napak

Pri triažah programskih napak lahko pomagate pri issue tracker z reprodukcijo napake in pridobivanjem več informacij od poročevalcev hroščev, da se zoži mesto, kjer težava nastane. Cenimo tudi zapiranje podvojenih vprašanj in vzdrževanje reda. Za več informacij glejte smernice triaže hroščev bug triaging guidelines.

Nove zmožnosti in popravki napak

Ali znate programirati? Sledite tem korakom:

  1. Predložite težavo pri svoji zmožnosti ali hrošču na KDE issue tracker.
    Opomba: Ta korak je potreben za zagotovitev, da nova funkcijaizpolnjuje cilje projekta ali da hrošč v resnici ni predvidena zmožnost. Gotovo se želite tudi uskladiti, katero področje kode boste posodobili in obenem izognili tako sporom spajanja v primeru, da nekdo drug dela na istem področju kode kot vi.
  2. Po razpravi o vaši novi ugotovitvi programirajte svojo funkcijo ali popravite napako. Prosimo sledite vodilom KDE Frameworks coding style guide. Pomembno: Prosimo, naj bo koda osredotočena na težavo. Nepovezane spremembe kode pripadajo ločenim vprašanjem/zahtevkom za lažji pregled kode in testiranje.
  3. Vložite zahtevek za povlek iz glavne veje s posodobitvami kode.
    Pomembno: Prosimo, stlačite svoje objave v git, preden oddate zahtevek za povlek!
  4. Počakajte na kratek pregled kode in da vsaj dva druga prostovoljca preizkusita vašo zmožnost ali popravek napake.
  5. Izvedite posodobitve vašega zahtevka za izvlečevanje, ko prejmete povratne informacije.
  6. Ko vaš zahtevek za poteg odobrita vsaj dva druga prostovoljna preizkuševalca, bo vaša zahteva za poteg spojena.

Pregled kode

Ali znate programirati in imate oko za podrobnosti? Prostovoljno se prijavite za strokovni pregled novih zahtevkov za združitev kode!

  1. Poglejte za nove zahtevke za združevanje - new merge request in dodajte komentar, da se prostovoljno javljate za pregled te kode.
  2. Predložite komentarje pregleda kode.
  3. Počakajte na posodobitve zahtevka za združitev (če je potrebno).
  4. Nadaljujte s povratnimi informacijami, dokler niste prepričani, da je koda pravilna.
  5. Pustite komentar s svojo odobritvijo zahtevka za združitev.
  6. Ko vsaj dva prostovoljna preizkuševalca predložita svojo odobritev, bo zahtevek za združitev izveden.

Tukaj je nekaj nasvetov, kaj iskati pri pregledih kode:

  • Ali predložena koda sledi vodilom KDE Frameworks coding style guide?
  • Ali je koda berljiva s komentarji, ki pojasnjujejo vse neočitne vrstice?
  • Ali je koda "pesimistična"? Z drugimi besedami, ali preverja neveljavne vrednosti, preden jih uporabi in obravnava morebitne napake?
  • Ali je več primerjav ali stavkov, zavitih v oklepaje znotraj stavkov 'if' za preprečevanje napak pri vrstnem redom delovanja? Primeri:
    // Napačno
if (a == b || c > d);

// Pravilno
if ((a == b) || (c > d));
  • Ali so literali na levi strani operatorja ==, ki preprečujejo napako vrste operatorja = ušli obvestilu prevajalnika? Primeri:
    // Napačno
if (variable == 1);

//         Razlog: Kaj, če je tam zatipkano? Prevajalnik tega ne bo zaznal!
if (variable = 1); // Opsa!
// Pravilno
if (1 == variable);

//         Razlog: Tokrat bo prevajalnik zaznal zatipkano.
if (1 = variable); // Opsa!

Testiranje

Prostovoljno se javite za pregled kode in testiranje novih zmožnosti in popravkov napak! Sledite naslednjim korakom:

  1. Poglejte za nove zahtevke za združevanje - new merge request in dodajte komentar, da se prostovoljno javljate za testiranje tega.
  2. Ustvarite zahtevo za spajanje na svoji platformi.
  3. Testirajte zmožnost/popravek napake in ga poskusite pokvariti!
  4. Zagotovite povratni odziv glede na rezultate testiranja v zahtevku za združevanje.
  5. Počakajte na posodobitve zahtevka za združitev (če je potrebno).
  6. Nadaljujte s testiranjem in zagotavljanjem povratnih informacij, dokler niste prepričani, da je koda deluje pravilno.
  7. Pustite komentar s svojo odobritvijo zahtevka za združitev.
  8. Ko je vsaj še en prostovoljec predložil odobritev testov, bo zahtevek za združevanje sprejet.

Prevodi

Prosimo, razmislite o pridružitvi skupini za prevajanje KDE - joining the KDE translations team, da prevedete svoje najljubše aplikacije druge jezike.

Tehnična podpora

Se dobro spoznate na Linux ali izgradnjo programja za macOS? Znajte popraviti težavo na katero so naleteli drugi? Odgovarjanje na vprašanja uporabnikov in odpravljanje težav v KDE bug tracker bi bilo zelo cenjeno!