připomenutí předchozí hodiny a uvedení problému „Dokumentace změn a pracovní deník“. 5–12 min: stručná teorie – changelog, pracovní deník, rozhodnutí, problém, další krok. 12–18 min: společná ukázka prvního kroku a kontrolních kritérií. 18–36 min: samostatná práce nebo práce ve dvojici – Doplnit ke třem commitům pracovní deník a přehled změn verze. 36–41 min: vzájemná kontrola podle zadání a oprava zjištěné chyby. 41–45 min: uložení výstupu (Pracovní deník a přehled změn), krátký exit ticket a pojmenování dalšího kroku.
Správa verzí a dokumentace · 45 minut
Dokumentace změn a pracovní deník
Žák zaznamená důvod změny, její dopad a další krok.
00
ČASOVÁ OSA
Struktura 45minutové hodiny
01
VIDEO LEKCE
Ukázka a vysvětlení postupu
▶
Video je připravené k doplnění
Video ukáže princip, první kroky, kontrolu a typickou chybu. Nebude obsahovat celý hotový upravitelný úkol.
provider: youtube · youtubeId: ""02
STUDIJNÍ MATERIÁL
Výklad: z čeho se učíš
Správa verzí uchovává historii práce a dokumentace vysvětluje, co projekt dělá, jak se používá a proč se změnil.
V hodině „Dokumentace změn a pracovní deník“ je hlavním cílem: Žák zaznamená důvod změny, její dopad a další krok. Nejde pouze o dokončení jednotlivých kliknutí nebo příkazů; důležité je umět vysvětlit, proč zvolený krok vede k cíli a co se v průběhu práce mění.
Klíčové pojmy changelog, pracovní deník, rozhodnutí, problém, další krok tvoří společný jazyk pro popis řešení. Při praktické práci v prostředí „Repozitář a textový dokument“ sleduj vstup, jednotlivé kroky, mezivýsledek a způsob kontroly. Pokud některý krok nelze popsat nebo zopakovat, postup ještě není dostatečně přesný.
Praktická část vychází ze zadání: Doplnit ke třem commitům pracovní deník a přehled změn verze. Výsledkem musí být „Pracovní deník a přehled změn“. Hotový výstup nestačí pouze ukázat; musí být možné doložit, že vznikl z pracovních podkladů a že splňuje uvedená hodnoticí kritéria.
Před odevzdáním ověř zejména: Dohledatelnost rozhodnutí a návaznost na commity. U programů nebo modelů použij více vstupů, u diagramů zkontroluj vztahy a popisky, u dokumentace ověř úplnost. Chybu nejprve přesně popiš, potom změň jen jednu věc a znovu výsledek otestuj.
Slovníček pojmů
changelog
Chronologický přehled důležitých změn mezi verzemi projektu.
pracovní deník
Průběžný záznam provedených kroků, rozhodnutí, problémů, testů a dalších plánovaných činností.
rozhodnutí
Místo algoritmu, kde se podle pravdivosti podmínky vybírá jedna z více možných cest.
problém
Situace, ve které současný stav neodpovídá požadovanému cíli a je potřeba najít řešení.
další krok
Konkrétní nejbližší činnost navazující na aktuální stav práce.
03
ŘÍZENÁ PRÁCE
Postup krok za krokem
- 01
Ve studentské lekci si přečti cíl a otevři pracovní podklady. Připrav prostředí: Repozitář a textový dokument. Originální podklady ponech beze změny a pracuj s kopií ve vlastní složce.
- 02
Pojmenuj pracovní složku ve tvaru „64_dokumentace-zmen-a-pracovni-denik_prijmeni“. Uvnitř odděl zdrojové soubory, vlastní práci a výsledný export.
- 03
Rozděl zadání na menší ověřitelné kroky: Doplnit ke třem commitům pracovní deník a přehled změn verze. Nejprve vytvoř nejjednodušší funkční nebo srozumitelnou variantu.
- 04
Po každém významném kroku výsledek spusť, otevři nebo jinak zkontroluj. Zapisuj testovací vstup, skutečný výsledek a případnou opravu; neměň více nezávislých věcí najednou.
- 05
Porovnej práci s kritérii „Dohledatelnost rozhodnutí a návaznost na commity“. Oprav alespoň jednu konkrétní slabinu zjištěnou vlastní nebo vrstevnickou kontrolou.
- 06
Ulož zdrojovou i výslednou podobu. Odevzdej „Pracovní deník a přehled změn“ v požadovaném formátu a přidej krátké zdůvodnění, jak jsi správnost ověřil/a.
04
PRACOVNÍ PODKLADY
Stáhni si soubory, se kterými budeš pracovat
Náhled ukazuje pouze strukturu a typ výsledku. Hotové upravitelné řešení ve studentské části není.
.TXT
64 Podklady Readme
↓Pracovní podklad určený k samostatnému zpracování.
64_PODKLADY_README.txt · 1 kB.MD
64 Repozitar Scenar
↓Pracovní podklad určený k samostatnému zpracování.
64_repozitar_scenar.md · 1 kB.TXT
64 Historie Zmen
↓Pracovní podklad určený k samostatnému zpracování.
64_historie_zmen.txt · 1 kBDůležité: Podklady jsou vstupy k práci, nikoli kompletní řešení. Vlastní výsledek musí vzniknout podle zadání, testu a reflexe.
05
OTEVŘENÉ ODPOVĚDI
Pracovní list
1. Startovací otázkaStačí 2–3 věty; důležitý je konkrétní výchozí příklad.
Co už o tématu „Dokumentace změn a pracovní deník“ víš? Uveď konkrétní příklad nebo situaci.
2. Práce s pojmyDefinici spoj s konkrétním krokem, hodnotou nebo částí výstupu.
Vysvětli vlastními slovy alespoň tři pojmy: changelog, pracovní deník, rozhodnutí, problém, další krok. Ke každému přidej použití v dnešní úloze.
3. Rozhodnutí a zdůvodněníUveď nejméně dvě možné varianty a kritérium volby.
Které rozhodnutí je při řešení úkolu „Doplnit ke třem commitům pracovní deník a přehled změn verze.“ nejdůležitější a podle čeho je uděláš?
4. Plán praktické prácePostup má mít vstup, očíslované kroky, kontrolu a očekávaný výstup.
Rozepiš vlastní postup k zadání: Doplnit ke třem commitům pracovní deník a přehled změn verze.
5. SebekontrolaKaždou otázku musí být možné zodpovědět důkazem z práce.
Převeď hodnoticí kritéria na kontrolní otázky: Dohledatelnost rozhodnutí, návaznost na commity.
6. Exit ticketOdpověď musí být konkrétní a vztahovat se k dnešní práci.
Napiš jeden pochopený princip, jednu provedenou opravu a jeden další krok.
06
PRAKTICKÁ PRÁCE
Dokumentace změn a pracovní deník
Doplnit ke třem commitům pracovní deník a přehled změn verze. 1. Pojmenuj pracovní složku ve tvaru „64_dokumentace-zmen-a-pracovni-denik_prijmeni“. Uvnitř odděl zdrojové soubory, vlastní práci a výsledný export. 2. Rozděl zadání na menší ověřitelné kroky: Doplnit ke třem commitům pracovní deník a přehled změn verze. Nejprve vytvoř nejjednodušší funkční nebo srozumitelnou variantu. 3. Po každém významném kroku výsledek spusť, otevři nebo jinak zkontroluj. Zapisuj testovací vstup, skutečný výsledek a případnou opravu; neměň více nezávislých věcí najednou. 4. Porovnej práci s kritérii „Dohledatelnost rozhodnutí a návaznost na commity“. Oprav alespoň jednu konkrétní slabinu zjištěnou vlastní nebo vrstevnickou kontrolou.
Očekávaný výstup
Pracovní deník a přehled změn
07
DŮKAZ O UČENÍ
Odevzdání praktického úkolu
ZIP balíček
Pracovní deník a přehled změn
Dokonči praktickou práci a odevzdej důkaz: Pracovní deník a přehled změn. Použij studentské podklady, zpracuj je samostatně a před odevzdáním projdi kontrolní kritéria. Hotové řešení je dostupné pouze v učitelské části.
Zatím nebyl vybrán žádný soubor.
V samostatném HTML se ukládají odpovědi a názvy vybraných souborů pouze do tohoto prohlížeče. Skutečný upload provede aplikace Kurzy/Studio.
08
ZÁVĚREČNÁ KONTROLA
Test
09
REFLEXE
Co si z lekce odnášíš
Dokončeno neznamená pouze vytvořeno. Po dokončení lekce prokážeš cíl odevzdáním výstupu: Pracovní deník a přehled změn. Výsledek zkontroluj podle kritérií: Dohledatelnost rozhodnutí a návaznost na commity.