Příklad v pseudokódu: vezmete metodu, která sčítá dvě čísla. Test zavolá soucet(2, 3) a očekává 5. Pokud metoda vrátí cokoli jiného, test selže. To je celé. První test by měl být takto triviální, abyste si ověřili, že framework funguje, že se test spouští a že vidíte výsledek. Teprve poté přidávejte složitější scénáře, jako jsou okrajové hodnoty, prázdné vstupy nebo výjimky.
Psaní smysluplných commit zpráv je dovednost, která se vyplácí především při zpětné dohledatelnosti změn. Když se kód po měsících vrátíte, nebo když ho prochází jiný člen týmu, kvalitní zpráva ušetří hodiny zmatků. Nejde o žádnou vědu – stačí dodržet pár zásad, které vám i ostatním usnadní orientaci v historii projektu.
Pozor také na ignorování konvence týmu. Pokud máte nastavený formát pro commit zprávy (např. prefixy jako feat, fix, refactor), dodržujte ho. Konvence nejsou byrokracie, ale nástroj pro rychlé filtrování v logu. A pokud začínáte nový projekt, nastavte si jednoduché pravidlo hned na začátku – snáz se to
udržuje než později.
Verzování kódu často začíná jako jednoduchá záležitost: commit, tag, release. Jakmile ale projekt začne používat více knihoven, které se vyvíjejí vlastním tempem, přestává stačit intuitivní přístup. Než se pustíte do samotné implementace, je nutné si ujasnit, jaké úrovně verzí vlastně potřebujete. Máte interní knihovny, které sdílíte mezi týmy, a zároveň externí závislosti? Pro každou úroveň pak platí jiná pravidla. Klíčové je oddělit verzi aplikace od verzí jednotlivých knihoven – jinak se brzy ztratíte v tom, která kombinace vlastně produkuje funkční celek.
Migrace databáze mezi dvěma odlišnými systémy není jen kopírováním dat. MySQL a PostgreSQL se liší v datových typech, chování transakcí, syntaxi SQL i v přístupu k indexům. Nejčastější chybou bývá spoléhat na automatické nástroje bez předchozí analýzy schématu. Než začnete, zmapujte si všechny tabulky, pohledy, triggery a uložené procedury. Zvláštní pozornost věnujte sloupcům typu ENUM, které PostgreSQL nepodporuje nativně – převeďte je na text s CHECK omezením nebo
nábytek na míru samostatnou číselníkovou tabulku.
Jak strukturovat zprávu, aby dávala smysl Praktický postup: první řádek do 50 znaků shrnuje podstatu změny, druhý řádek nechte prázdný a pak pokračujte podrobnostmi. V hlavičce použijte imperativ, jako „přidej validaci e-mailu" nebo „odstraň duplicitní dotaz". Tělo zprávy pak rozveďte – co bylo špatně, proč jste zvolili toto řešení, jaké alternativy jste zvažovali. Vyhněte se ale zbytečným detailům o implementaci, které jsou vidět v kódu.
Základem je popsat, co a změnili, ne jak. Místo „oprava bugu" napište „oprava pádu při načítání prázdného seznamu". Místo „úprava stylů" zkuste „sjednocení rozestupů v hlavičce pro mobilní zobrazení". Důležité je, aby příjemce zprávy pochopil kontext, aniž by musel otevírat samotný diff. K tomu pomáhá i uvedení čísla ticketu nebo úkolu, pokud jej používáte – ale vždy doplňte i slovní popis, ne jen číslo.
Nejprve si definujte měřitelné cíle. Typicky to může být zkrácení doby nasazení z týdne na jeden den, snížení počtu chyb v produkci nebo zmenšení čekací doby na testovací prostředí. Konkrétní čísla vám pomohou ověřit, jestli vaše snahy mají smysl. Nezavádějte změny plošně – vyberte jeden malý tým nebo jeden projekt, kde můžete nové postupy vyzkoušet bez velkého rizika.
Zá
úložné prostory v malém bytěěrem: psaní commit zpráv berte jako součást práce, ne nutné zlo. Když si na to zvyknete, zabere vám to pár sekund navíc, ale ušetří to hodiny při hledání příčiny problému nebo při
code review. Až budete příště psát „oprava", zastavte se a zeptejte se, co přesně a proč – a napište to.
Pro samotnou správu závislostí používejte nástroj, který umožňuje uzamčení přesných verzí, nejen rozsahů. Vždy verzujte soubor se závislostmi, ať už se jedná o manifest nebo lockfile. Tento soubor by měl být součástí každého commitu, aby byla reprodukovatelnost buildů zaručena. Při aktualizaci knihovny pak postupujte podle principu nejmenšího kroku: nejprve aktualizujte opravné verze, otestujte, pak vedlejší a nakonec hlavní. Pamatujte, že aktualizace hlavní verze často znamená změnu chování, ne jen nové API. Proto si před takovým krokem vždy načtěte changelog a porovnejte rozdíly mezi verzemi.
Nakonec si zvykněte testy spouštět automaticky, ideálně při každém uložení nebo před odesláním změn do sdíleného repozitáře. Pokud testy běží až večer, je snadné je ignorovat. Rychlá zpětná vazba je klíčová. Nebojte se, že první testy budou pomalé nebo že jich bude málo. Každý test, který projde, vám dává jistotu. Až narazíte na chybu, kterou test odhalí, pochopíte, proč se vyplatí je psát.
