Prispevek h kodi

Ali nameravate prispevati k ogrodju Nette in se morate seznaniti s pravili in postopki? Ta priročnik za začetnike vas bo popeljal skozi korake za učinkovito prispevanje h kodi, delo z repozitoriji in izvajanje sprememb.

Postopek

Če želite prispevati h kodi, morate imeti račun na GitHubu in poznati osnove dela s sistemom za nadzor različic Git. Če sistema Git ne poznate, si lahko ogledate priročnik git – the simple guide in razmislite o uporabi enega od številnih grafičnih odjemalcev.

Priprava okolja in skladišča

  1. Na spletnem mestu GitHub ustvarite vilico skladišča paketov, ki ga nameravate spremeniti
  2. Klonirate to shrambo v svoj računalnik
  3. Z ukazom composer install namestite odvisnosti, vključno s programom Nette Tester.
  4. Preverite, ali testi delujejo, tako da zaženete composer tester
  5. Ustvarite novo vejo, ki temelji na zadnji izdani različici

Izvajanje lastnih sprememb

Zdaj lahko izvedete lastne prilagoditve kode:

  1. Izvedite želene spremembe in ne pozabite na teste
  2. Poskrbite, da se testi uspešno izvedejo z uporabo composer tester
  3. Preverite, ali koda ustreza standardom kodiranja
  4. Shranite (commit) spremembe z opisom v tejobliki

Ustvarite lahko več zavez, po eno za vsak logični korak. Vsaka oddaja mora biti smiselna sama po sebi.

Oddaja sprememb

Ko ste s spremembami zadovoljni, jih lahko predložite:

  1. Spremembe prenesite na GitHub v svojo vilico
  2. Od tam jih predložite v skladišče Nette tako, da ustvarite pull request (PR)
  3. V opisu navedite dovolj informacij

Vključevanje povratnih informacij

Vaše oddaje so zdaj vidne drugim. Pogosto prejmete komentarje s predlogi:

  1. Spremljajte predlagane spremembe
  2. Vključite jih kot nove spremembe ali jih združite s prejšnjimi
  3. Ponovno pošljite spremembe v GitHub in samodejno se bodo pojavile v zahtevi za povlečenje.

Nikoli ne ustvarjajte nove zahteve za prenos, da bi spremenili obstoječo zahtevo.

Dokumentacija

Če ste spremenili funkcionalnost ali dodali novo, ne pozabite tega dodati tudi v dokumentacijo.

Nova veja

Če je mogoče, spremembe izvedite glede na zadnjo izdano različico, tj. zadnjo oznako v veji. Za oznako v3.2.1 ustvarite vejo s tem ukazom:

git checkout -b new_branch_name v3.2.1

Standardi kodiranja

Vaša koda mora ustrezati standardom kodiranja, ki se uporabljajo v okviru Nette. Za preverjanje in popravljanje kode je na voljo samodejno orodje. Namestite ga lahko globalno prek programa Composer v izbrano mapo:

composer create-project nette/coding-standard /path/to/nette-coding-standard

Orodje lahko zaženete v terminalu. Prvi ukaz preveri, drugi pa popravi kodo v mapah src in tests v trenutnem imeniku:

/path/to/nette-coding-standard/ecs check
/path/to/nette-coding-standard/ecs check --fix

Obveznost Opis

V sistemu Nette imajo predmeti sprememb naslednjo obliko: Presenter: fixed AJAX detection [Closes #69]

  • sledi dvopičje
  • namen zaveze v preteklem času; če je mogoče, začnite z besedami, kot so: added, fixed, refactored, changed, removed
  • če oddaja krši združljivost za nazaj, dodajte “BC break”
  • kakršno koli povezavo s programom za sledenje težavam, na primer (#123) ali [Closes #69]
  • za temo je lahko ena prazna vrstica, ki ji sledi podrobnejši opis, na primer vključno s povezavami do foruma

Opis zahtevka za izvleček

Pri ustvarjanju zahteve za prenos vam vmesnik GitHub omogoča vnos naslova in opisa. Navedite jedrnat naslov in v opis vključite čim več informacij o razlogih za vašo spremembo.

V naslovu navedite tudi, ali gre za novo funkcijo ali popravek napake in ali lahko povzroči težave s povratno združljivostjo (BC break). Če obstaja povezana težava, se nanjo povežite, tako da bo po odobritvi zahteve za spremembo zaprta.

- bug fix / new feature?  <!-- #issue numbers, if any -->
- BC break? yes/no
- doc PR: nette/docs#?    <!-- highly welcome, see https://nette.org/en/writing -->