Dokumentace pro vývojáře, nebo pro stroje? Rozdíl, který rozhoduje
Na konci sprintu si ukažte přírůstek, který je skutečně hotový — otestovaný, integrovaný a použitelný. Ne prezentaci o tom, co by šlo. Retrospektiva má mít jeden konkrétní výstup: změnu, kterou tým v příštím sprintu vyzkouší. Vyhněte se seznamu deseti přání, která nikdo nesleduje. Lepší je jedna úprava, kterou opravdu provedete, než pět bodů, které zapadnou.
Here is more on podrobnosti look at our own website. Sprint jako experiment, ne jako deadline Plánování sprintu postavte na jedné otázce: co nejcennějšího dokážeme dodat do konce cyklu a jak poznáme, že to funguje? Odhadujte společně a v relativních jednotkách, ne v hodinách. Délku sprintu držte zpočátku krátkou, dva týdny jsou pro začátek rozumné. Během sprintu měňte obsah jen výjimečně a vždy s vědomím, že něco jiného vypadne. Denní patnáctiminutovka slouží k synchronizaci, ne k reportování vedení. Pokud se z ní stane kontrola, lidé přestanou mluvit o problémech a začnou mluvit o tom, co šéf chce slyšet.
Nastavte také jasná pravidla pro tagy v Gitu. Každý release by měl mít tag, který odpovídá verzi balíčku, například názvem balíčku a verzí. To usnadní dohledání, co která verze obsahovala. Pokud používáte monorepo s více jazyky, sjednoťte formát tagů napříč ekosystémy. Častou chybou je zapomenutí na dokumentaci – changelog by měl být součástí repozitáře a generovat se automaticky z commitů, ne ručně.
Testování chybových stavů a hraničních hodnot začíná u otázky, co je pro daný vstup platné a co už ne. Bez jasné definice se testování zvrhne v hádání. Proto si nejdřív sepište všechna pravidla: povolené znaky, minimální a maximální délku, povinné položky, formát čísel a datumů. Teprve z těchto pravidel odvoďte konkrétní testovací případy. Pokud pravidla nejsou, testujte to, co je zřejmé, a zbytek nahlaste jako nejasnost.
REST je bezpečná volba tam, kde je rozhraní jednoduché a stabilní. Dobře se kešuje na úrovni HTTP, snadno se ladí v prohlížeči i v nástrojích příkazové řádky a každý vývojář ví, DokončEní InteriéRu co znamená GET, POST nebo DELETE. Pozor ale na typickou chybu: návrh endpointů podle databázových tabulek místo podle toho, co klient opravdu potřebuje. Výsledkem je mnoho volání pro jednu obrazovku a zbytečné přenosy. Pokud se počet požadavků začne šplhat a klient musí skládat data z pěti odpovědí, je to signál, že REST přestává stačit.
Častou chybou je zavádět Scrum najednou v celé firmě a čekat, že se vše srovná. Začněte jedním týmem a jedním produktem. Měřte, co tým skutečně dodá, a porovnávejte to s tím, co si naplánoval. Po třech až čtyřech sprintech uvidíte, kde se ztrácí čas. Možná zjistíte, že největší brzdou není vývoj, ale čekání na schválení nebo nejasné zadání. To je cennější informace než jakýkoli certifikát. Až budete mít první výsledky, teprve pak řešte rozšíření na další týmy.
Pro nezávislé verzování potřebujete nástroj, který sleduje, které balíčky se od posledního vydání změnily, a podle toho navrhne nové verze. Mezi osvědčené patří nástroje pro správu monorep, které umí pracovat s changelogy a tagy v Gitu. Klíčové je nastavit, aby se změny v jednom balíčku nepromítly do verzí ostatních, pokud na nich nezávisí. Typickou chybou je ruční zvyšování verzí bez vazby na skutečné změny – vznikají pak verze, které nic neobsahují, nebo naopak chybí verze s opravou.
Při nastavování dávejte pozor na závislosti mezi balíčky. Pokud balíček A závisí na balíčku B a B se změní, musí se aktualizovat i verze A, Rady pro Rekonstrukci i když se v něm nic nezměnilo. To je častý zdroj chyb: vývojář upraví B, zapomene na A a při instalaci se použije stará verze. Řešením je, aby nástroj uměl propagovat změny závislostí. Také se vyhněte pevnému zadávání verzí v manifestech – používejte rozsahy, které odpovídají sémantickému verzování, ale ne příliš široké, aby se nezavlekly nechtěné změny.
Jak nastavit verzování v praxi Začněte tím, že v kořeni repozitáře vytvoříte konfiguraci pro nástroj, který bude spravovat verze. Ten by měl mít seznam balíčků a pravidla, jak určit typ změny (oprava, nová funkce, breaking change). Dále nastavte, aby se při každém commitu do hlavní větve spouštěla kontrola, která zjistí, zda je potřeba nová verze. Nástroj by měl automaticky upravit verze v souborech manifestů a vytvořit changelog. Propojte to s CI, aby se změny verzí commitovaly zpět do repozitáře nebo aby se release provedl jako samostatný krok.
Postman není jen klient pro rychlé odeslání požadavku. Pokud ho používáte jako testovací nástroj, klíčové je ukládat požadavky do sbírek a spouštět je opakovaně. Začněte tím, že každý požadavek uložíte do sbírky (Collection) a pojmenujete ho podle endpointu a metody, například „GET /users – seznam". Do sbírky přidejte proměnné prostředí (Environment) pro základní URL, token a identifikátory. Pak stačí přepnout prostředí a stejná sbírka funguje proti vývojovému i testovacímu serveru. Vyhněte se natvrdo zapsaným hodnotám v URL i těle požadavku – právě ty způsobují, že testy projdou lokálně a selžou jinde.