Podmínky studia

Pravidla a pokyny pro odevzdávání kódu.

Požadavky na studentskou práci

Budete pracovat na vlastních projektech. Během práce musíte plnit následující požadavky:


1. Průběžná práce na GitHubu

2. Kvalita commitů

3. Komentování kódu

4. Technická dokumentace


Do skriptů a na GitHub nevkládejte, žádné osobní údaje (jméno, příjmení, e-mail, telefon, adresa atd.)!


Postup práce a struktura repozitáře

  1. Výběr názvu: Vyberete si název projektu a zaznamenáte ho do hlavní tabulky v souboru README.md v kořeni repozitáře. Jinými slovy stanovíte si cíl!
  2. Organizace souborů: Každý projekt musí mít svou vlastní samostatnou složku. Veškerý kód, modely a obrázky k danému projektu budou pouze uvnitř této složky (např. složka 01_snake).
  3. Dokumentace projektu: Projekt stručně popíšete a dokumentaci uložíte do souboru ve formátu:
    • Název musí končit slovem _projekt.md (např. 01_Snake_hra_projekt.md).
    • Soubor musí být umístěn přímo uvnitř složky daného projektu.

[!IMPORTANT] Než začnete pracovat na samotném kódu projektu, musíte si vybrat jeho název a popsat jej v souborech README.md a [nazev]_projekt.md. V souboru README.md jsou postupně uváděny názvy projektů a jejich stručné popisy. Soubor [nazev]_projekt.md je vždy uložen ve složce konkrétního projektu a obsahuje podrobnější popis projektu.


Šablony souborů

Formát souboru README.md

Pořadové číslo, název projektu, datum zápisu (pro vaši vlastní evidenci do budoucna).

Formát souboru projekt.md

Obsah dokumentace (vytvářena souběžně)

Dokumentace bude obsahovat následující informace: * Název projektu, na kterém pracujete. * Popis a cíl projektu. * Popis funkcionality programu. * Technická část: použité knihovny, algoritmy, vlastní datové struktury, nebo volání externího API atd.