5 zásad pro čitelné commit zprávy, které ocení i vaše budoucí já
Psaní commit zpráv patří mezi činnosti, které většina vývojářů odbývá. Přitom právě tyto krátké texty tvoří chronologický záznam o vývoji projektu. Když do nich po půl roce nahlédnete, měly by vám okamžitě odpovědět na tři otázky: co se změnilo, proč se to změnilo a jaké to má důsledky. Bez těchto informací se i dokonalý kód stává nesrozumitelnou hromadou znaků.<br>
<br>
<br>
<br>
Než začnete psát první řádky kódu, ujasněte si, co má stránka dělat. HTML je kostra, CSS je vzhled. Bez kostry se CSS nemá čeho chytit, bez CSS vypadá kostra jako dokument z devadesátých let. Základní struktura HTML dokumentu je jednoduchá: doctype, html, head a body. Do head patří meta informace a odkaz na CSS soubor, do body veškerý viditelný obsah. Pokud vynecháte doctype, prohlížeč se přepne do takzvaného quirks módu a vaše CSS bude fungovat jinak, než čekáte. Tohle je nejčastější začátečnická chyba, která se projeví až při stylování.<br>
<br>
<br>
<br>
Jaké informace do těla zprávy patří a jaké ne Do podrobné části patří kontext: jaký problém jste řešili, jaké alternativy jste zvažovali a proč jste vybrali právě toto řešení. Dále sem patří případné vedlejší efekty – co se může rozbít, jaké další části kódu změna ovlivňuje. Typickou chybou je opisování rozdílu v kódu. Pokud jste přidali podmínku, nepíšete „Přidal jsem if, který kontroluje věk", ale „Zabraň přístup uživatelům mladším 18 let".<br>
<br>
<br>
<br>
Na závěr si dejte pozor na přehnané množství pluginů. Instalace desítek rozšíření může zpomalit prostředí a způsobit konflikty. Vybírejte jen to, co skutečně využijete, a pravidelně kontrolujte, která rozšíření jsou aktivní. Pokud si osvojíte práci s klávesovými zkratkami a využijete vestavěné funkce, zjistíte, že většinu úkolů zvládnete bez zbytečných přídavků. Rozhodnutí o IDE by nemělo být jednorázové – po půl roce práce se vyplatí znovu vyhodnotit, jestli vám nástroj stále vyhovuje, a případně přejít na efektivnější řešení.<br>
<br>
<br>
<br>
Pro práci s CSS používejte externí soubor, ne style přímo v HTML. Oddělení obsahu od vzhledu vám umožní měnit design bez zásahu do struktury. Stačí v head připojit odkaz na CSS soubor a v něm definovat pravidla. Selektory píšete podle tříd, id a elementů. Třídy jsou univerzální, id používejte jen pro jedinečné prvky. Pokud chcete nadpis označit modře, napište .nadpis a v HTML <br>
<br>
. Vyhněte se stylování podle id, protože to snižuje přehlednost a ztěžuje pozdější úpravy.<br>
<br>
<br>
<br>
Pozor i na příliš vágní formulace. Slova jako „oprava", „úprava", „vylepšení" nebo „refaktoring" bez bližšího určení nenesou žádnou informaci. Místo „Refaktoring kódu" napište „Odděl logiku pro výpočet slev od zpracování objednávky". Podobně se vyhněte hláškám typu „drobné úpravy", které neříkají, co bylo změněno a proč. Pokud je změna opravdu triviální, raději ji slučte s jinou smysluplnou.<br>
<br>
<br>
<br>
Dalším častým problémem je ignorování výjimek. Když uživatel zadá místo čísla text a vy ho převedete pomocí Convert.ToInt32(), program spadne. Místo toho použijte int.TryParse(), který vrátí true nebo false podle toho, jestli se převod podařil. Tím zajistíte, že se program nerozběhne po každém špatném vstupu. Vyzkoušejte si to na jednoduché kalkulačce – sčítání dvou čísel, kde uživatel zadá hodnoty a program vypíše výsledek. Budete překvapeni, kolik toho takový malý projekt naučí.<br>
<br>
<br>
<br>
Když už máte funkční kód, zaměřte se na čitelnost. Pojmenovávejte proměnné tak, aby vypovídaly o obsahu – místo a a b použijte prvniCislo a druheCislo. Uvnitř metody Main držte kód krátký a logicky členěný. Pokud zjistíte, že opakujete stejný kód, vytvořte si vlastní metodu. Tím se dostanete k základům objektového programování, které je pro C# klíčové. Nemusíte hned rozumět třídám a dědičnosti, ale zvykněte si na to, že kód se dá strukturovat.<br>
<br>
<br>
<br>
Další častou chybou je míchání více nesouvisejících změn do jednoho commitu. Například když opravíte překlep v dokumentaci a zároveň změníte logiku výpočtu ceny. Takový commit se špatně čte, špatně vrací zpět a komplikuje hledání chyb. Ideální commit mění jednu věc. Pokud potřebujete udělat dvě nesouvisející úpravy, rozdělte je do dvou commitů. I kdybyste měli poslat oba najednou, historie zůstane čistá.<br>
<br>
<br>
<br>
Pro práci s poli a objekty jsou klíčové metody jako `map`, `filter` a `reduce`. Místo `for` smyček s vedlejšími efekty použijte `map` pro transformaci a `filter` pro výběr. `reduce` je mocný, ale i zrádný – pokud zapomenete inicializační hodnotu, chová se jinak, než čekáte. Nezapomínejte, že tyto metody nevytvářejí hlubokou kopii – mění pouze prvky, ale vnořené objekty zůstávají sdílené. Pro immutabilní aktualizace použijte spread operátor: `const novyPole = [...pole, prvek];` nebo `const novyObjekt = ...objekt, key: value ;`. Tím se vyhnete mutaci původních dat – klíčové pro React nebo jiné frameworky, které spoléhají na referenční porovnání.