Testování reducerů a async akcí bez integračního prostředí
Prvním krokem je inicializace projektu. Ve složce, kde máte zdrojové soubory webu, otevřete terminál a spustíte příkaz pro vytvoření nového repozitáře. Tím se vytvoří skrytá složka, do které se ukládají metadata o změnách. Důležité je vědět, že verzovat byste měli pouze zdrojové soubory – HTML, CSS, JavaScript a podobně. Vygenerované soubory, jako jsou minifikované skripty nebo nahrané obrázky, do verzování nepatří, protože je lze kdykoliv znovu vytvořit. K tomuto účelu slouží soubor s ignorovanými položkami, do kterého zapíšete seznam souborů a složek, které se mají přeskočit.<br>
<br>
<br>
<br>
Pokud si netroufáte na kód, začněte s dokumentací. Přidávání příkladů, opravování překlepů nebo doplnění chybějících sekcí je stejně hodnotné jako oprava bugů. Zkuste si nasadit projekt lokálně a projít dokumentaci krok za krokem – určitě narazíte na místa, která nejsou jasná. Takové poznatky pak můžete přetavit v konkrétní návrh na zlepšení. U dokumentace je důležité držet se stručnosti a přesnosti, vyhýbat se zbytečnému balastu.<br>
<br>
<br>
<br>
Dalším krokem je práce s box modelem. Každý prvek na stránce je obdélník, který má padding, border a margin. Padding je vnitřní okraj (mezera mezi obsahem a rámečkem), border je rámeček a margin je vnější okraj (mezera mezi prvky). Často se stává, že začátečníci zapomenou na reset okrajů, proto se prvky „lepí" k sobě nebo se liší v různých prohlížečích. Na začátek si pomozte univerzálním selektorem * a nastavte margin: 0; padding: 0; box-sizing: border-box; – tím získáte předvídatelnější chování.<br>
<br>
<br>
<br>
Typické chyby, které dělají začátečníci, jsou: zapomenutí koncového lomítka u prázdných elementů (např. ), chybné uzavírání značek, používání inline stylů místo CSS tříd, nebo absence responzivního designu. Pro responzivitu používejte media queries – v CSS definujte pravidla pro různé šířky obrazovky. Například pro mobilní zařízení pod 600 pixelů můžete změnit velikost písma nebo skrýt některé prvky. Také se vyhněte používání tabulek pro rozvržení – používejte flexbox nebo grid, což je moderní a jednodušší.<br>
<br>
<br>
<br>
Začněte u reducerů. Reducer je funkce, která přijímá stav a akci a vrací nový stav. Testování spočívá v tom, že zavoláte reducer s konkrétním stavem a akcí a porovnáte výsledek s očekávaným. Důležité je neměnit původní stav – reducer musí být čistý. Při psaní testů vždy vytvořte nový objekt stavu, abyste předešli vedlejším efektům. Typická chyba je testovat reducer přes celý store, což zbytečně komplikuje izolaci. Místo toho importujte reducer přímo a testujte ho jako samostatnou jednotku.<br>
<br>
<br>
<br>
Základním stavebním kamenem je popis každého endpointu. Uveďte jeho HTTP metodu, cestu a účel – co dělá, jaká data přijímá a co vrací. Nezapomeňte na příklady požadavků a odpovědí, a to včetně hlaviček a stavových kódů. Často se stává, že dokumentace obsahuje jen příklady úspěšné odpovědi, ale chybí popis chybových stavů. Přidejte proto tabulku možných chyb – proč k nim dochází, jak vypadá tělo odpovědi a jak by na ně měl frontend reagovat. Typickou chybou je také opomenutí autentizace – popište, jak se token předává, kdy expiruje a co se stane při neplatném přístupu.<br>
<br>
<br>
<br>
Dobrá dokumentace by měla obsahovat i ukázkové scénáře použití. Místo izolovaných příkladů ukažte, jak jednotlivé endpointy spolupracují při řešení typické úlohy – třeba jak načíst seznam položek, přidat novou, upravit ji a smazat. To pomáhá frontendu pochopit kontext a návaznosti. Nezapomeňte také na popis stránkování, filtrování a řazení, pokud je API podporuje – frontend pak nemusí vymýšlet vlastní řešení. V neposlední řadě myslete na to, že dokumentace by měla být snadno prohledávatelná. Používejte konzistentní názvy, členění do sekcí a klíčová slova. Vyhněte se zdlouhavým úvodům a marketingovým frázím – jde o technický manuál, ne o prodejní text.<br>
<br>
<br>
<br>
Verzování a změny: jak dokumentaci udržet živou REST API se vyvíjí, a proto je nutné dokumentaci verzovat. Kořte se vždy k verzi API, kterou používáte, a při změnách jasně označte, co je nové, co je změněné a co je odstraněné. Zavedte pravidlo, že každá změna v kódu backendu, která ovlivní rozhraní, musí mít odpovídající změnu v dokumentaci – jinak dokumentace rychle zastará a stane se nepoužitelnou. Užitečné je uvádět i datum poslední aktualizace a možnost porovnat verze. Typickým problémem je, že dokumentace popisuje staré endpointy, které už nefungují, nebo naopak neobsahuje nově přidané funkce. Proto dokumentaci pravidelně kontrolujte a testujte – ideálně přímo z dokumentace.<br>
<br>
<br>
<br>
Dokumentace REST API často bývá tím posledním, na co vývojáři myslí. Přitom právě ona rozhoduje o tom, jak rychle frontend pochopí možnosti backendu a jak bez chyb je využije. Dobře vedená dokumentace není luxus, ale nástroj, který šetří hodiny práce oběma stranám. Než začnete psát, ujasněte si, kdo bude dokumentaci číst – frontend vývojář, který nezná interní strukturu vašeho systému. Pište tedy srozumitelně, strukturovaně a hlavně konkrétně.