návaznost na předchozí práci a uvedení problému „README, návod, licence a přehled změn“. 5–12 min: teoretické minimum – README, účel, spuštění, publikace, licence, changelog, omezení. 12–18 min: společná ukázka principu a kontrolních kritérií. 18–36 min: samostatná práce nebo práce ve dvojici – Vytvořit dokumentaci a nechat spolužáka ověřit postup. 36–41 min: test, vzájemná kontrola nebo cílená konzultace. 41–45 min: uložení výstupu (Ověřená dokumentace), krátká reflexe a určení dalšího kroku.
Správa verzí, testování a dokumentace · 45 minut
README, návod, licence a přehled změn
Připraví dokumentaci pro otevření, použití a další rozvoj produktu.
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číš
Téma „README, návod, licence a přehled změn“ patří do celku „Správa verzí, testování a dokumentace“. Nejde pouze o ovládání nástroje: cílem je porozumět rozhodnutím, která vedou od zadání k ověřitelnému digitálnímu výstupu.
Klíčové pojmy README, návod, HTML popisují základní stavební prvky dnešní práce. Pojmy CSS, JavaScript, licence pomáhají výsledek kontrolovat, vysvětlit nebo porovnat s jinou variantou. Každý pojem proto použij v konkrétním kroku, nikoli jen v definici.
Pracovat budeš v prostředí „Markdown nebo textový dokument“. Nejprve si uchovej původní podklady, potom vytvoř pracovní kopii a změny prováděj po menších ověřitelných krocích. Po každé důležité změně výsledek otevři, spusť nebo porovnej s požadovaným chováním.
Praktické zadání zní: Doplnit README s popisem spuštění webu, používaného JavaScriptu, datových souborů, licence a známých omezení. Výsledkem je „Ověřená dokumentace“. Nestačí, aby výstup pouze existoval; musí být možné doložit, že splňuje cíl: Připraví dokumentaci pro otevření, použití a další rozvoj produktu.
Kvalitu posuzuj podle těchto hledisek: Úplnost, Aktuálnost a správná licence. Před odevzdáním zkontroluj názvy a strukturu souborů, funkčnost na čistém nebo cílovém prostředí a připoj stručnou reflexi rozhodnutí, testu a případné opravy.
Slovníček pojmů
README
Úvodní dokument vysvětlující účel projektu, instalaci, spuštění, strukturu a způsob použití.
návod
Dohledatelný popis účelu, struktury, použití a údržby produktu nebo postupu.
HTML
Značkovací jazyk, který popisuje strukturu a význam obsahu webové stránky.
CSS
Jazyk pravidel určujících vzhled, rozložení a přizpůsobení webového dokumentu.
JavaScript
Programovací jazyk používaný v prohlížeči pro logiku, práci s daty a interaktivní změny webové stránky.
licence
Pravidla stanovená držitelem práv, která určují, jak lze dílo používat, upravovat a šířit.
struktura projektu
Pojem „struktura projektu“ označuje konkrétní prvek nebo pravidlo používané při tématu této lekce; jeho význam se ověřuje na pracovním příkladu a podle výsledného výstupu.
přehled změn
Pojem „přehled změn“ označuje konkrétní prvek nebo pravidlo používané při tématu této lekce; jeho význam se ověřuje na pracovním příkladu a podle výsledného výstupu.
03
ŘÍZENÁ PRÁCE
Postup krok za krokem
- 01
Otevři prostředí „Markdown nebo textový dokument“ a vytvoř si vlastní pracovní složku s číslem lekce. Původní podklady neměň; nejprve je zkopíruj do pracovní verze.
- 02
Přečti zadání a napiš si jednou větou očekávaný výsledek: Ověřená dokumentace. Označ vstupy, omezení a nejméně tři kontrolní kritéria.
- 03
Rozbal startovní projekt a spusť jej přes lokální webový server, pokud lekce načítá JSON. Otevři vývojářskou konzoli a ověř, že neobsahuje neošetřenou chybu.
- 04
Doplň JavaScript po malých funkcích. Po každé změně otestuj běžný, hraniční a neplatný vstup, stav po obnovení stránky a ovládání klávesnicí podle zadání.
- 05
Proveď sebekontrolu podle kritérií: Úplnost; Aktuálnost a správná licence. Zaznamenej alespoň jeden test nebo porovnání.
- 06
Ulož zdrojovou i výslednou verzi pod jednoznačnými názvy. Odevzdej „Ověřená dokumentace“ a krátce popiš, jak jsi ověřil/a správnost.
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í.
Dů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. Výchozí představaNapiš konkrétní příklad, ne pouze obecný dojem.
Co už o tématu „README, návod, licence a přehled změn“ víš a kde ses s ním setkal/a?
2. Práce s pojmyKe každému pojmu přidej situaci, ve které ovlivňuje rozhodnutí.
Vysvětli vlastními slovy alespoň tři pojmy: README, návod, HTML, CSS, JavaScript, licence.
3. Rozhodovací situaceUveď kritérium, důkaz a možné omezení.
Jaké dvě možné varianty řešení připadají v úvahu a podle čeho mezi nimi rozhodneš? Téma: README, návod, licence a přehled změn.
4. Plán praktické prácePostup musí obsahovat vstup, konkrétní kroky, kontrolu a výstup.
Rozepiš vlastní postup k zadání: Doplnit README s popisem spuštění webu, používaného JavaScriptu, datových souborů, licence a známých omezení.
5. SebekontrolaFormuluj kontrolní otázky, které lze skutečně zodpovědět ano/ne nebo měřením.
Jak ověříš, že je výstup „Ověřená dokumentace“ správný? Vycházej z kritérií: Úplnost, Aktuálnost a správná licence.
6. Exit ticketOdpověď má být konkrétní a vztahovat se k dnešní práci.
Napiš jeden princip, jednu provedenou kontrolu a jeden další krok.
06
PRAKTICKÁ PRÁCE
README, návod, licence a přehled změn
Doplnit README s popisem spuštění webu, používaného JavaScriptu, datových souborů, licence a známých omezení.
Očekávaný výstup
Ověřená dokumentace
07
DŮKAZ O UČENÍ
Odevzdání praktického úkolu
Soubor a krátká odpověď
Ověřená dokumentace
Odevzdej výstup „Ověřená dokumentace“. Přilož zdrojové soubory nebo export a krátce popiš, jak jsi výsledek zkontroloval/a.
Zatím nebyl vybrán žádný soubor.
Offline verze ukládá pouze odpovědi a názvy vybraných souborů v prohlížeči; skutečný upload provede Studio po napojení API.
08
ZÁVĚREČNÁ KONTROLA
Test
09
REFLEXE
Co si z lekce odnášíš
Dokončeno neznamená pouze vytvořeno. Výsledek je dokončený tehdy, když je uložený, otevřitelný, otestovaný a vysvětlitelný podle kritérií. Zapiš jednu provedenou kontrolu, jednu opravu a jeden další krok.