Když se bugfixy hromadí, osm návyků je drží pod kontrolou

Z Mazovia

Praktický postup je jednoduchý. Sepište seznam činností včetně těch nudných, ke každé přiřaďte odhad v rozsahu (nejlépe v hodinách), a teprve pak je sečtěte. Rozsah nutí přemýšlet o nejistotě, zatímco jedno číslo ji schová. U činností, které nejdou odhadnout, určete časový box a podmínku, za které se pokračuje dál. Do odhadu započítejte i přerušení: běžný pracovní den není osm hodin soustředěné práce a plán, který to předpokládá, selže.

Tělo zprávy vysvětluje důvod, ne průběh práce Pokud změna není triviální, odděl první řádek prázdným řádkem a napiš odstavec o tom, rady pro rekonstrukcič je změna potřeba. Uveď původní chování, problém a nové chování. Nepopisuj, že jsi otevřel soubor a přejmenoval proměnnou — to je vidět z diffu. Naopak uveď, jaký okrajový případ to řeší, nebo na co si dát pozor při nasazení.

Automatizované testy vyžadují stabilní identifikátory prvků. Pokud vývojář mění názvy tlačítek nebo přesouvá komponenty, testy padají na nesprávných místech. Řešením je domluvit se na přístupových identifikátorech, které zůstávají neměnné, a testy psát proti nim. Vyhněte se přes souřadnice – na různých rozlišeních selžou. Pro mobilní aplikace se osvědčují nástroje, které umí spustit testy na skutečných zařízeních i emulátorech a zároveň pořizují snímky obrazovky při selhání.

Držte počet rozpracovaných oprav nízký. Když má jeden člověk otevřených pět chyb, žádná se nehne dopředu. Omezte souběžnost a dokončujte. Oprava není hotová sloučením změny — hotová je tehdy, když ji ověří někdo jiný než autor a když je popsáno, proč chyba vznikla. Bez toho se stejná chyba vrátí za měsíc v jiné podobě.

Nejčastější chyba je commitování všeho naslepo. Do projektu se tak dostanou dočasné soubory, hesla nebo velké binárky, které historii nafouknou. Vytvoř soubor .gitignore a vypiš do něj, co Git sledovat nemá. Druhá častá chyba je práce přímo v hlavní větvi bez zálohy; než začneš něco většího měnit, udělej větev. A třetí: mazání složky .git „pro vyčištění" — tím smažeš celou historii a už ji nevrátíš.

U rozsáhlejších změn používej konvenci, které týmu rozumí: prefix oblasti nebo typu změny, například „docs:", „fix:", „refactor:". Drž se jednoho stylu napříč repozitářem a zapiš ho do souboru s pokyny pro přispěvatele. Konzistence je důležitější než dokonalý formát — historie se pak dá filtrovat a číst po oblastech.

Opravy chyb se hromadí hlavně proto, že se k nim přistupuje jako k něčemu, co se udělá „mezitím". Ve chvíli, kdy má tým otevřených deset oprav a každá čeká na někoho jiného, začíná se ztrácet přehled. První krok není nový nástroj, ale rozhodnutí, že oprava chyby je normální práce s vlastním časem v plánu, ne odpad, který se vejde do mezer mezi úkoly.

Pro kurzor je klíčové mít jednoznačné a stabilní řazení. Kombinace sloupce s časovým razítkem a primárního klíče funguje spolehlivě: klient pošle obě hodnoty posledního záznamu a server sestaví podmínku, která využije složený index. Pozor na řazení pouze podle data vytvoření — při shodných hodnotách se záznamy mohou ztratit nebo zdvojit mezi stránkami. Vždy přidejte do ORDER BY unikátní sloupec, i když se to zdá zbytečné.

Poslední zásada: commitovat často a po malých krocích. Velký commit s dvaceti nesouvisejícími změnami se špatně hledá a ještě hůř vrací. Když se něco pokazí, git log ti ukáže historii a git checkout s kódem commitu tě vrátí k funkční verzi. Nauč se tyto čtyři příkazy pořádně a zbytek přijde s praxí.

Každý odhad vývojového úkolu stojí na viditelné části: napsat kód, spustit testy, odevzdat. Skryté činnosti kolem toho ale často tvoří polovinu skutečné práce. Když je nezapočítáte, odhad vypadá dobře na papíře a padá v prvním týdnu. Cílem není přidat paušální rezervu, ale rozložit odhad na konkrétní činnosti, které opravdu nastanou.

Než commit dokončíš, přečti si zprávu očima někoho, kdo o změně nic neví. Pokud musíš dohledávat souvislosti, zpráva je nedostatečná. Dobrá zpráva šetří čas při hledání příčiny chyby, při code review i při návratu k vlastní práci po měsících.

Naléhavost neposuzujte podle toho, kdo si stěžuje nejhlasitěji, ale podle dopadu: kolik lidí to postihuje, zda přicházejí o data a zda existuje rozumná náhradní cesta. Chyby, které ničí data nebo blokují celý postup, jdou první. Kosmetické vady počkají a je užitečné to nahlas říct, aby se na ně nezapomínalo potichu.

Git je nástroj, který si pamatuje, jak se soubory v projektu měnily v čase. Každou uloženou změnu zabalí do takzvaného commitu — snímku stavu s krátkou zprávou, kdo a proč ji udělal. Bez Gitu se při práci ve dvou lidech snadno stane, že jeden přepíše druhého a stará verze se ztratí. S Gitem se dá kdykoli vrátit k předchozímu stavu a zjistit, která změna něco rozbila. Pro začátek si nainstaluj Git a nastav jméno a e-mail, protože se připisují ke každému commitu: git config --global user.name "Jméno" a git config --global user.email "adresa". Pak v adresáři projektu spusť git init, čímž vznikne skrytá složka, kde Git drží celou historii. Do ní nesahej a nemaž ji.