Do dokumentace napiš, jaký typ stránkování který endpoint používá, jaké filtry jsou povolené a jak se chová řazení. Klient, který nezná pravidla, si bude vymýšlet vlastní a ty pak budeš hasit výpadky. Stabilní kurzor, indexované filtry a tvrdý limit na velikost stránky vyřeší většinu problémů dřív, než vzniknou.
Jak ověřit slučitelnost licencí u závislost
Testuj s někým, kdo produkt nezná. Posaď ho před obrazovku, zadej mu úkol a mlč. Sleduj, kde se zasekne, a neobhajuj svůj návrh. Pět takových sezení odhalí víc než týden hádání. Zapisuj si, co lidi říkají, ale věř tomu, co dělají. A nakonec: design není jednorázová fáze před kódováním, ale něco, co se upravuje s každou další funkcí.
Rozložení stavěj na mřížce a nech prvkům prostor. Těsné rozestupy vypadají amatérsky a ztěžují orientaci. Drž se pravidla blízkosti: co patří k sobě, je blízko; co je oddělené, má větší mezeru. Nepoužívej víc než tři úrovně nadpisů a hlídej, aby se hierarchie dala přečíst na první pohled. Když váháš, jestli něco zvýraznit, raději ne.
Metodika pro kanban se udrží jen tehdy, když ji tým používá k rozhodování. Jednou za čas se sejděte a projděte, které sloupce nebo limity už nefungují, a upravte je. Změna není selhání, je to součást provozu. Pokud se pravidla nemění a přesto práce plynule ubývá, máte vyhráno — a to je jediné měřítko, které stojí za to sledovat.
Začněte definicí hotovo. Nestačí říct, že úkol je hotový, když je „nějak uzavřený". Napište konkrétní podmínky: kód je otestovaný, zadání je ověřené, zákazník potvrdil výsledek. Každý sloupec by měl mít vlastní kritérium odchodu, ne jen jeden obecný stav. Teprve pak se dá měřit, kde práce skutečně vázne. Typická chyba je, že tým přesune kartu do dalšího sloupce, i když podmínky nesplňuje — jen aby tabule vypadala čistě.
Kam s konfigurací, když ne do kódu Pro konfiguraci použijte samostatný repozitář nebo centrální úložiště, které umí verzovat změny nezávisle. Oddělený repozitář může mít vlastní historii, vlastní pravidla pro review a vlastní přístupová práva. Vývojáři potřebují právo měnit výchozí hodnoty v kódu, ale přístup k produkčním tajemstvím by měl být omezený. Pokud používáte konfigurační soubory, držte je v samostatné struktuře a do kódu přidejte pouze ukázkový soubor bez citlivých údajů. Nikdy necommitujte soubor s reálnými hesly, ani když ho hned smažete. Zůstane v historii a odstranit ho odtud je nepříjemné.
Vyhýbejte se sdílenému mutovatelnému stavu, kde to jde. Globální proměnné a objekty předávané mezi funkcemi, které je mění, dělají tok dat nepředvídatelným. Pokud funkce vrací novou hodnotu místo toho, aby přepisovala vstup, snáz se testuje a snáz se čte. Stejně tak dávejte přednost malým modulům s jasně vymezeným rozhraním před jedním velkým souborem, kde se všechno odkazuje na všechno.
Zavést kanban je snadné, udržet ho v chodu je těžší. Většina týmů selže nikoli na samotné tabuli, ale na pravidlech, která si nikdy nedomluvila. Metodika pro kanban nestojí na nástroji, ale na dohodě o tom, co jednotlivé sloupce znamenají, kdy se karta posouvá a kdo má právo rozhodnout, že je práce hotová. Bez této dohody se tabule do měsíce změní v dekoraci.
Barvu nepoužívej jako jediný nosič informace. Červená a zelená nestačí, protože je část populace nerozliší. Přidej ikonu nebo text. Stejně tak kontrast textu vůči pozadí musí být dostatečný, jinak si lidé na slunci nebo se slabším zrakem neporadí. Písmo drž na dvou velikostech a dvou řezech, víc variant působí chaoticky.
Prvním krokem je rozhodnout, co je kód a co konfigurace. Kód popisuje chování, konfigurace popisuje prostředí. Prakticky to znamená, že do repozitáře kódu patří výchozí hodnoty, schéma konfigurace a validační logika. Skutečné hodnoty pro vývoj, test a produkci patří jinam. Pokud aplikace čte konfiguraci z proměnných prostředí, udržujte v kódu pouze seznam povinných proměnných a jejich formát. Tím se kód stane přenositelným a prostředí se nastavuje bez zásahu do zdrojáků.
Limity nedokončené práce nejsou dekorace Klíčovým pravidlem kanbanu je omezit množství práce rozpracované současně. Určete pro každý sloupec maximální počet karet. Když limit dosáhnete, nezačínáte novou práci, ale pomáháte dokončit tu, která už běží. Právě tady vzniká největší odpor, protože lidé jsou zvyklí sáhnout po dalším zadání, když se zaseknou. Pomáhá viditelné pravidlo: pokud je sloupec plný, další karta se nepřidá, dokud se něco neuzavře. Limit nastavte zpočátku mírně, klidně o jednu kartu výš, než je současný stav, a postupně ho snižujte.