Testování API v Postmanu: co se stane, když využijete proměnné a kolekce

Klíčové je psát smysluplné zprávy k commitům. Místo „úpravy" napište „přidána validace e-mailu do formuláře". Pomůže to vám i kolegům. Před odesláním změn na vzdálený server si vždy projděte rozdíly (diff). Díky tomu odhalíte chyby, které byste jinak přehlédli. A pokud si nejste jistí, jak přepínat mezi větvemi, nezoufejte – stačí pár základních příkazů a zbytek se naučíte za pochodu.

Pozor na běžné nástrahy. První z nich je psát zprávy v minulém čase – commit zpráva popisuje, co jste udělali, ale lépe působí rozkazovací způsob: „Přidej ošetření prázdného vstupu" místo „Přidal jsem ošetření". Druhým častým problémem je míchání více nesouvisejících změn do jednoho commitu. Pokud opravujete bug a zároveň přejmenováváte proměnnou, měly by to být dva commity. Jinak se v historii ztrácíte a nelze bezpečně vrátit jen jednu změnu.

Základní pravidlo zní: commit zpráva má odpovídat na otázku PROČ, ne jen CO. Samotný diff vám řekne, jaké řádky se změnily, ale neřekne vám, jaký problém jste tím řešili. Proto se vždy vyplatí začít stručným shrnutím, které popisuje záměr změny – třeba „oprava pádu při prázdném vstupu" místo „fix null". Takové shrnutí by mělo být krátké, ideálně do 50 znaků, aby se vešlo do přehledu historie.

Když zvolíte NoSQL, počítejte s tím, že se vzdáváte univerzálního jazyka Relační databáze mají jednotný dotazovací jazyk SQL, který ovládá každý vývojář. U NoSQL neexistuje žádný standard. Každý typ databáze – dokumentová, sloupcová, grafová – používá jinou syntaxi a jiné API. To znamená, že pokud začnete s jednou implementací a později zjistíte, že nevyhovuje, přechod na jinou NoSQL databázi je prakticky kompletní přepsání datové vrstvy. Připravte se na to, že budete muset studovat dokumentaci a testovat dotazy, které v SQL zvládnete intuitivně.

Flexbox využijte pro distribuci prostoru v rámci jednoho řádku. Klasickým příkladem je hlavička s logem a navigací. Naboďte kontejneru display: flex; a pomocí justify-content: space-between rozmístěte prvky od kraje ke kraji. Pro vertikální centrování použijte align-items: center;. Flexbox vyniká v tom, že prvkům umožňuje měnit velikost na základě dostupného místa – flex: 1 1 auto; způsobí, že se prvky rovnoměrně roztáhnou. Ale nenechte se unést: příliš mnoho flex vlastností v jednom kontejneru vede k nepředvídatelnému chování na malých obrazovkách, proto testujte na skutečných zařízeních.

Základní návyk: commit jako kotva, ne jako povinnost Začněte tím, že si vytvoříte repozitář přímo v projektu. Už jen to, že máte lokální historii, změní váš přístup. Každou funkci, opravu nebo úpravu stylů ukládejte do malých, logických kroků. Například přidání tlačítka je jeden commit, změna jeho barvy je druhý. Vyhnete se tak situaci, kdy po týdnu nevíte, co se v kódu stalo. Než začnete pracovat, vždy si vytvořte novou větev (branch). To je váš oddělený prostor, kde můžete experimentovat, aniž byste ohrozili stabilní verzi.

Jak strukturovat zprávu, aby byla čitelná i za rok Dobrá zpráva má dva oddíly: předmět a tělo. Předmět je věta, která shrnuje podstatu. Tělo pak rozvádí důvody, případně souvislosti – co bylo předtím, co teď a proč. Typickou chybou je psát jen předmět a tělo vynechat. Pokud je změna netriviální, tělo je nezbytné. Použijte třeba odrážky pro výčet důsledků, ale držte se věcného tónu. Vyhněte se emocím a obecným frázím – místo „zlepšeno" napište konkrétně „snížena spotřeba paměti o 15 % díky cachování výsledků dotazu".

Při návrhu responzivního rozhraní stojíte před volbou, zda sáhnout po CSS Gridu nebo Flexboxu. Nejde o konkurenci, ale o dva nástroje, které řeší odlišné typy rozvržení. Grid pracuje ve dvou osách současně a hodí se pro celkovou strukturu stránky, jako jsou hlavička, obsah a patička. Flexbox je jednorozměrný a exceluje tam, kde potřebujete zarovnat prvky v řadě nebo sloupci s pružným chováním. Zjednodušeně: pokud stavíte kostru stránky, použijte Grid; pokud řešíte rozložení karet, tlačítek nebo navigace, použijte Flexbox.

Třetí chybou je psát zprávy typu „WIP" nebo „temp". Takové commity signalizují, že nevíte, co děláte, a připravují past pro budoucí hledání. Pokud potřebujete uložit rozpracovanou práci, použijte větvičku nebo stash, ale nikdy nezasílejte do sdílené historie commit bez smyslu. A pokud už takový commit omylem vytvoříte, opravte ho před push do sdílené větve – ideálně pomocí interaktivního rebase, ale to je téma na samostatný článek.

Poslední rada: pište zprávy v jazyce, kterému rozumí celý tým. Většinou je to angličtina, ale pokud jsou členové týmu Češi, klidně pište česky. Důležité je, aby to bylo jednotné a srozumitelné. A když si nejste jistí, jestli je zpráva dobrá, zkuste si představit, že podle ní máte za rok vysvětlit změnu novému kolegovi. Pokud to nejde, zprávu přepište. Smysluplné commit zprávy nejsou luxus, ale základní hygieny projektu – ušetří vám i ostatním spoustu času a nervů.