Skip to content

Latest commit

 

History

History
99 lines (73 loc) · 3.69 KB

CONTRIBUTING.adoc

File metadata and controls

99 lines (73 loc) · 3.69 KB

Kako sodelovati pri predmetu Numerična matematika

Ta repozitorij je namenjem zbiranju gradiv in izdelavi domačih nalog pri predmetu Numerična matematika. Želimo si, da skupaj ustvarimo lepo urejen in zaokrožen repozitorij z vsemi gradivi, ki jih bomo ustvarili na vajah in z domačimi nalogami. Zato ste vsi študenti, ki ste vpisani na ta predmet vabljeni, da se pridružite temu projektu in sodelujete pri tem.

Laboratorijske vaje

Na laboratorijskih vajah bomo iskali ravnotežje med razlago na tablo in programiranjem asistenta in samostojnim delom študentov. Vaje bodo (upam) uravnotežena mešanica:

  • razlage na tablo

  • programiranja na projektorju

  • nekaj samostojnega programiranja

Note
 Del svojih obveznosti lahko študent opravi že na vajah, če za naloge, ki jih bomo reševali na vajah, izdela rešitev in poda zahtevo za združitev merge request.

Domače naloge/sprotno delo

Domače naloge oziroma sprotno delo bo potekalo sodelovalno. To pomeni, da bomo skupaj razvijali knjižnico numeričnih funkcij v tem repozitoriju. Poleg tega naj bi vsak študent naredil eno nalogo v svojem repozitoriju.

Za pozitivno oceno naj bi študent prispeval več stvari v eni od naslednjih oblik:

  • rešitve domačih nalog v obliki zahteve za združitev(merge request)

  • pregled rešitev domačih nalog svojih kolegov

Ocena se določi na podlagi kvalitete prispevkov

  • na oceno vplivajo le dobri prispevki, če kdo kdaj pošlje kakšno neumnost, se mu to ne šteje v minus

  • ko študent zbere dovolj prispevkov, mu asistent dodeli oceno

  • ocena se lahko le še popravi z bolj kvalitetnimi prispevki

Domače naloge oddajte kot zahtevo za združitev (merge request). Spodaj je zelo na kratek opis, kako to naredite. Predpostavljam, da ste vsaj malo vešči z orodjem Git.

Seznam opravil za domačo nalogo:

  • ❏ odprete zahtevek

  • ❏ pripravite zahtevo za združitev

  • ❏ napišete kodo, teste in dokumentacijo

  • ❏ povabite kolega za pregled

  • ❏ izdelek izboljšate

  • ❏ ko vaš kolega potrdi vašo nalogo, povabite še asistenta za pregled

  • ❏ asistent vašo odobri vejo (ali pa zahteva dodatne popravke)

  • ❏ veja se združi v glavno vejo

Delo z izvorno kodo z Git-om

  • najprej si na svojem računalniku ustvarite klon repozitorija

git clone https://gitlab.com/nummat/nummat-2122.git
cd nummat-2122

  • nato ustvarite novo vejo

git branch nickname-dn1
git checkout nickname-dn1

  • nalogo rešite in sproti spremembe z git commit beležite v repozitorij.

  • nalogo prenesete na strežnik z ukazom git push

git push origin nickname-dn1

Merge request na Gitlab

Ko ste svojo rešitev dokončali in jo uspešno prenesli na gitlab, lahko ustvarite merge request. Za source izberete svojo vejo, za target pa vejo master.

Note
 Bolj podroben opis načina dela z git in gitlab je opisan v dokumentu o načinu dela(workflow).