Jarmil
Období: Týden 17/2026 (od 26.04.) Skupina: tria URL: https://github.com/samuelmichnik-oss/Jarmil.git
1. Splnění základních podmínek
| Podmínka | Status |
|---|---|
| Alespoň 3 commity v daném týdnu | ✅ SPLNĚNO |
| Rozestup alespoň 12h mezi 3 commity | ✅ SPLNĚNO |
| Projektová dokumentace (README, projekt.md) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-04-27 05:46: Refactor comment formatting in Snake_hra_projekt.py
- 2026-04-30 14:57: Fix capitalization in project description
- 2026-05-02 19:30: Fix comments
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 7 / 20 b. (35%) |
| Náročnost projektu (Index) | 1 |
| Počet commitů | 3 |
| Změněné soubory | 2 |
| Počet přid./odeb. řádků kódu | 13 |
Komentář a zpětná vazba od AI
Zde je hodnocení tvé práce na projektu Snake Game za uplynulý týden:
1. Smysluplnost popisů u commitů [2 body]
Popisy tvých commitů jsou sice věcné a odpovídají provedeným změnám (např. „Fix capitalization“, „Fix comments“), ale jejich obsah je velmi chudý. Vzhledem k tomu, že jsi v celém týdnu prováděl pouze drobné estetické úpravy, commity postrádají informaci o jakémkoliv skutečném vývoji funkcionality.
2. Smysluplnost komentářů v kódu [2 body]
V této oblasti jsi se zaměřil výhradně na vizuální stránku – upravoval jsi odsazení komentářů (např. u #vykreslení) nebo měnil formát oddělovačů (z # --- na # =Pause nebo zkracování linek). Oceňuji snahu o úhledný kód, ale komentáře by měly primárně vysvětlovat „proč“ a „jak“ daná část kódu funguje, což se tento týden nedělo.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]
Struktura repozitáře je v pořádku a splňuje zadaná pravidla. Projekt má svou vlastní složku /Snake_game/, ve které jsou uloženy příslušné soubory, a v kořenovém adresáři se nachází pouze /README.md. Dokumentace v Projekt.md je srozumitelná, i když změna „Had“ na „had“ byla v kontextu nadpisu spíše redundantní.
4. Logika řešení a přemýšlení studenta v Pythonu [1 bod]
V této kategorii musím být přísný. Tvým cílem je vytvořit hru Snake, ale za celý týden jsi do souboru Snake_hra_projekt.py nepřidal žádnou novou logiku, funkci ani opravu výpočetního algoritmu. Veškeré změny byly kosmetické (smazání prázdného řádku, změna pomlček v komentáři, posun odsazení komentáře). zde je chyba v přístupu k práci – programování je o tvorbě algoritmů a funkcí, nikoliv o nekonečném přepisování komentářů bez postupu v kódu. Progrese k naplnění cíle je pro tento týden nulová.
Celkem získáno bodů: [7 / 20] (35 %)
DIFFICULTY_INDEX: [1]
Kontrolní otázka k obhajobě
V souboru Snake_hra_projekt.py jsi v rámci refaktoringu komentářů u bonusu („power“) posunul odsazení na hlubší úroveň, zatímco příkazy
score += 3apower = Nonezůstaly v diffu na stejné úrovni odsazení jako samotná podmínkaif– mohl bys mi vysvětlit, jak se tento blok kódu v Pythonu zachová při spuštění a co jsi tímto odsazením sledoval?