Ověřte si originalitu textu dřív, než ho zveřejníte
Finální kontrola by měla proběhnout až po všech úpravách. Znovu projděte celý text, zvláště pak místa, která jste přepisovali. Ideální je nechat dokument chvíli „odležet" a vrátit se k němu s čerstvou myslí. Můžete také požádat kolegu či známého, aby si text přečetl a upozornil vás na pasáže, které mu připadají stylově odlišné. Čerstvý pohled často odhalí to, co vám uniklo. Teprve když máte jistotu, že je text skutečně vaším autorským dílem, můžete ho s klidným svědomím publikovat.
Pokud teprve začínáte, zkuste si rebase nacvičit na nepodstatné větvi, kterou klidně zahodíte. Git je relativně shovívavý nástroj a většinu chyb lze napravit. Klíčem k úspěchu je disciplína a důslednost. Jakmile si tým zvykne na lineární historii, oceníte, jak snadno se v ní hledá, kdy byla která změna provedena a proč. Historie bez merge commitů není jen estetická záležitost, ale praktická výhoda pro každého, kdo se v projektu potřebuje rychle zorientovat.
Každý vývojář zná situaci, kdy hodiny hledá chybu, která se nakonec ukáže jako překlep v názvu proměnné nebo špatně pochopená logika. Čistý kód není o estetice, ale o tom, aby se v něm dalo rychle orientovat a předcházet zbytečným chybám. Následujících pět návyků vám pomůže snížit počet chyb i čas strávený laděním.
Prvním návykem je psát funkce, které dělají jen jednu věc. Pokud funkce kombinuje validaci vstupu, transformaci dat a zápis do úložiště, je těžké najít místo, kde se něco pokazí. Rozdělte ji na menší celky a pojmenujte je podle toho, co dělají. Typickou chybou je funkce s názvem zpracujUzivatele, která uvnitř mění heslo i odesílá e-mail. Místo toho použijte overUzivatele a posliUvitanouZpravu. Tím se usnadní testování i hledání chyb.
Zásadní roli hrál také vodní režim. Nové Město bylo protkáno potoky a rybníky, které dnes najdete pod povrchem. Při rekonstrukcích domů se často narazí na staré dřevěné vodovody z dubových kmenů. Pro běžného návštěvníka je praktičtější sledovat terénní nerovnosti – zejména v okolí Karlova náměstí. Pokud vám připadá, že se ulice mírně svažuje, nejde o klam: středověcí inženýři využili přirozený spád, aby voda z tržišť odtékala do kanalizačních stok, které ústily do Vltavy.
Základním nástrojem pro lineární historii je příkaz git rebase. Když dokončíte práci na své větvi a chcete ji začlenit do hlavní větve, místo git merge použijte git rebase main (samozřejmě po aktualizaci lokální hlavní větve). Tento příkaz přehraje vaše commity na konec aktuální hlavní větve. Výsledek vypadá, jako byste pracovali přímo na hlavní větvi, bez jakýchkoli větvení. Důležité je, že rebase přepisuje historii, proto ho provádějte pouze na commitach, které ještě nikdo jiný nesdílí.
Další situací, kdy neváhejte ani den, je viditelný otok na tváři nebo pod okem, který nemá zjevnou příčinu. Takový otok často signalizuje absces u kořene zubu, který vyžaduje okamžitý zákrok a nasazení antibiotik. Pozor také na to, pokud pes začne být apatický, ztrácí hmotnost nebo má horečku – bakterie z tlamy se mohou dostat do krevního oběhu a ohrozit srdce či ledviny. V takovém případě je rychlost důležitější než cena zákroku.
Začněte vlastní revizí a vyhledávači Prvním krokem je kontrola celého dokumentu v textovém editoru. Zaměřte se na pasáže, které jste možná psali ve spěchu, nebo které citují cizí myšlenky. U každé delší převzaté myšlenky si ověřte, že jste správně uvedli zdroj. Poté si vyberte klíčové věty – nejlépe ty, které obsahují specifická slovní spojení nebo odborné termíny – a vložte je do internetového vyhledávače v uvozovkách. Pokud se objeví přesná shoda s cizím textem, máte jasný signál k přepsání vlastními slovy a doplnění citace.
Pojmenovávání proměnných a struktura objektů Třetí návyk se týká pojmenovávání proměnných a funkcí. Vyhněte se zkratkám jako x, data nebo tmp. Místo toho použijte popisné názvy, které vyjadřují účel, například cenaPoSlevě nebo seznamObjednavek. U boolean hodnot používejte slovesa jako jeAktivni nebo maOprávneni. To platí i pro názvy souborů a složek – pokud se v projektu nevyznáte, strávíte víc času hledáním než psaním.
Většina týmů, které používají Git, se dříve nebo později setká s problémem nepřehledné historie. Merge commity vytvářejí zbytečné křižovatky, které znesnadňují orientaci v tom, co se vlastně změnilo a kdy. Pokud chcete, aby byla historie lineární a dobře čitelná, je vhodné se merge commitům vyhnout. Nejde o žádnou vědu, stačí změnit pár návyků a pochopit, jak Git interně pracuje s větvemi.