Jak funguje hodnocení vašich projektů

Váš kód a aktivita na GitHubu jsou každý týden analyzovány a hodnoceny naším automatizovaným systémem a umělou inteligencí. Cílem není jen napsat kód, který "nějak" funguje, ale naučit se pracovat systematicky, kód dokumentovat a prokazovat, že svému projektu rozumíte.

Celkové hodnocení vaší týdenní práce se vždy převádí do klíčové metriky zvané Index. Maximální Index, který můžete za jeden týden získat, je 100.

Z čeho se skládá váš Index (max 100 b.)

Index je složen ze dvou hlavních částí: bodování umělou inteligencí (40 %) a vaše disciplína při plnění pravidel (60 %).

1. Hodnocení kódu od AI (max 40 bodů do Indexu)

Umělá inteligence dostane váš nahraný kód, zprávy z commitů a cíl, který jste definovali v projektové dokumentaci. Za tyto podklady vám udělí až 20 surových bodů. Ty se pak vynásobí dvěma a tvoří až 40 bodů z vašeho celkového týdenního Indexu.

AI uděluje "surové body" ve 4 kategoriích:

Smysluplnost popisů u commitů (0 až 3 body)
Píšete hloupé zprávy typu "Update" nebo "jnjnj"? Ztratíte body.
Píšete zprávy dle návodu "Přidána funkce střelby" nebo "Oprava kolizí"? Získáte maximum.
Komentáře přímo v kódu (0 až 6 bodů)
Pokud je kód bez vašich komentářů nevysvětlený a složitý k pochopení, ztrácíte body.
Oceníme, když popíšete logiku, nad kterou jste museli přemýšlet.
Kvalita a srozumitelnost dokumentace (0 až 2 body)
Nehodnotí se tu samotná přítomnost souborů (viz níže), ale to, jak srozumitelně je v README.md či projekt.md popsáno, o co se v aplikaci snažíte nebo jaké knihovny využíváte.
Logika řešení a naplnění cílů (0 až 9 bodů)
Čím složitější cíl (např. interaktivní hra oproti pouhému součtu dvou čísel) si v repozitáři sami vytknete a následně programově realizujete, tím více bodů dostanete. Extrémně triviální úpravy bez návaznosti na vlastní stanovený cíl budou penalizovány (dostanete zpravidla jen max 2-3 body). Algoritmus a vaše přemýšlení je to nejdůležitější.

2. Plnění administrativních podmínek (max 60 bodů do Indexu)

Díky vašim návykům můžete získat většinu ze zbývajích bodů do Indexu. Systém hlídá z vaší aktivity tři parametry a za každý vám do Indexu napočítá přímý bonus 20 bodů:

Máte za týden min. 3 commity? (+ 20 bodů)
Pracovali jste průběžně a commity od sebe dělí více než 12 hodin? (+ 20 bodů)
Máte v repozitáři v aktuálním týdnu založené a commitnuté dokumenty projektu README.md a [nazev]_projekt.md? (+ 20 bodů)

Poznámka ke třetímu bodu: Právě z této dokumentace navíc čte umělá inteligence vaše vytyčené cíle pro to, aby spravedlivě přidělila body za "Logiku" viz sekce AI výše. Pokud tento dokument chybí, nejen že ztratíte 20 disciplinárních bodů, ale UI bude nejpřísněji hodnotit vaši "Logiku řešení".

Příklad výpočtu týdenního Indexu

Student pracoval průběžně po večerech. Odevzdal 3 commity s drobnými 12hodinovými rozestupy, popisy commitů byly obstojné. Neudělal sice obří pokrok v logice hry (AI mu dala jen 5 z 9 bodů), ale založil perfektní _projekt.md, ve kterém popsal cíl, a vše parádně ve skriptech okomentoval.

Hodnocení od AI (surové body): - Popisy commitů: 3/3 b. - Komentáře: 6/6 b. - Kvalita obsahu dok.: 2/2 b. - Logika kódu: 5/9 b. Celkem AI body: 16/20 (převod pro Index: 16 x 2 = + 32 bodů)

Splnění Podmínek: - 3 commity: Splněno (+ 20 bodů) - Rozestup nad 12h: Splněno (+ 20 bodů) - Přítomnost dokumentace: Splněno (+ 20 bodů) Celkem Podmínky: + 60 bodů

Výsledný Index studenta za tento týden: 92 (32 + 60) (Souhrnný agregovaný index za pololetí je pak pouhým součtem všech těchto získávaných týdenních Indexů k sobě.)