Jak začít s verzováním: průvodce Gitem pro začátečníky

Důležité je také komunikovat průběžně. Nečekejte, až termín vyprší. Jakmile zjistíte, že se práce protáhne, dejte vědět okamžitě. Krátká zpráva „posouvám se, ale mám zpoždění, nový termín je úterý" je vždy lepší než mlčení. Zákazník ocení, že ho berete vážně, a vy si zachováte důvěru. Naopak pokud mlčíte a pak oznámíte pozdní dodání, zákazník nabude dojmu, že jste o tom věděli už dřív, ale neřekli jste to. Tím si podkopáváte vlastní kredibilitu.

Dalším krokem je připočítat rezervu na chyby a nejistotu. Nejde o umělé nafouknutí odhadu, ale o realistické ohodnocení rizik. Pokud používáte novou technologii, přidejte více času na experimentování. Pokud úkol navazuje na cizí modul, počítejte s časem na pochopení jeho logiky. Vhodné je použít techniku tří bodů: optimistický, realistický a pesimistický odhad. Výsledný čas pak odvoďte ze vzorce (optimistický + 4 × realistický + pesimistický) / 6, který zohledňuje nejistotu.

Jak si ověřit, že jste na nic nezapomněli Konzultace s kolegy je nejefektivnější způsob, jak odhalit skryté činnosti. Požádejte někoho zkušeného, aby váš rozpad úkolu prošel a upozornil na chybějící kroky. Často se ukáže, že jste zapomněli na code review, aktualizaci dokumentace nebo nasazení do testovacího prostředí. Tyto činnosti sice nejsou vidět ve výstupu, ale bez nich není úkol hotový.

Základem je rozložit úkol na menší části a ke každé přiřadit čas na činnosti, které nejsou na první pohled vidět. Typicky jde o nastudování existujícího kódu, přípravu testovacích dat, konfiguraci prostředí nebo řešení neočekávaných závislostí. U každé části si položte otázku: „Co všechno musím udělat, abych tuto funkci dokončil?" Zapište si i zdánlivé maličkosti, jako je změna rozložení prvků nebo úprava textu – i ty vyžadují čas.
Při práci s Gitem je důležité si uvědomit, že commit je lokální záležitost. Pokud pracujete na vlastním počítači, nikam se neodesílá. Pro zálohu a spolupráci s ostatními budete potřebovat vzdálený repozitář, ale to je téma na další článek. Pro rekonstrukce koupelny krok za krokemčátek si osvojte lokální workflow a pravidelně commitujte. Zkuste si vytvořit malý projekt, dělejte v něm změny a vracejte se k předchozím verzím. Čím víc si tyto kroky procvičíte, tím přirozenější vám budou.

Další důležitý bod je zohlednit technický dluh. Pokud pracujete na starším kódu, počítejte s tím, že pochopení stávající logiky zabere víc času než psaní nové. Zkuste si projít kód, který budete měnit, a odhadněte, kolik času zabere jeho čtení. Často se vyplatí naplánovat si i čas na refaktoring, který vám ušetří práci v budoucnu. Nezahrnutí technického dluhu je jedna z nejčastějších příčin překročení odhadů.

Na závěr: dokumentace není jen seznam endpointů. Je to smlouva mezi týmy. Když ji napíšete dobře, frontend může pracovat samostatně a backend nemusí odpovídat na stejné dotazy desetkrát. Investujte čas do úvodního přehledu, autentizace a popisu chyb – to jsou tři nejčastější oblasti, kde vznikají problémy. A pokud dokumentace chybí, řešte to jako chybu v kódu, ne jako kosmetiku.

Jakmile máte Git připravený, Should you have any kind of queries concerning wherever along with how to make use of celý text, you are able to email us on our own web site. vytvořte si novou složku pro projekt a přejděte do ní v terminálu. Inicializujte repozitář příkazem git init. Tím vytvoříte skrytou složku .git, kde Git ukládá všechny informace o historii. Nyní můžete začít přidávat soubory. Pomocí git status zjistíte, které soubory jsou nové nebo změněné. Příkazem git add . přidáte všechny soubory do takzvané „připravené oblasti" (staging area). Poté provedete první commit příkazem git commit -m "První verze projektu". Commit je snímek vašich souborů v daném okamžiku, ke kterému se můžete kdykoli vrátit.

Nezapomeňte na chybové stavy. API bez dokumentace chyb je jako mapa bez výstražných značek. Popište běžné chyby, které se reálně vracejí: co znamená kód 400, kdy přijde 401 a jak vypadá tělo chyby. Uveďte, které položky jsou v chybě vždy a které jen někdy. Frontend pak může rovnou napsat ošetření bez toho, aby musel hádat, co přišlo. A hlavně – neschovávejte chyby pod obecný „error: true", ale vracejte strukturu, ze které backend pozná, co je špatně.

Nezapomínejte ani na čas na testování a ladění. Testy nejsou jen o psaní testů, ale také o spouštění, analyzování výsledků a opravách. Ladění může zabrat hodiny, zejména pokud se problém projevuje jen v určitých podmínkách. Zkuste si odhadnout čas na testování podle složitosti úkolu – u nové funkce počítejte s 30 % času na testy, u opravy bugu s 20 %. A nakonec si nechte rezervu na závěrečné review, kdy kolegové najdou nedostatky a vy je budete muset opravit.