Jak začít s Git: průvodce pro úplné začátečníky > 미얀마한인회

Když si osvojíte tyto tři příkazy (init, add, commit) a jednu větev (branch), máte základ, na kterém můžete stavět. Git má mnohem víc – tagy, rebase, cherry-pick, ale ty už nejsou pro začátek nutné. Nejdůležitější je si zapamatovat, že Git není kouzlo – je to jen nástroj, který zpřehlední vaši práci. Zkoušejte, dělejte chyby a vracejte se zpět pomocí git log a git revert. To je ta nejlepší cesta, jak se ho naučit.

Klíčem je rozdělit odhad na dvě samostatné položky, nikoli na jeden souhrnný číselný údaj. Analytickou fázi ohodnoťte jako samostatný úkol, podobně jako implementaci. Užitečné je použít relativní jednotky (např. story pointy), ale s tím, že analytická fáze dostane vlastní číslo. Praktickým vzorcem je poměr 1:2 až 1:3 – tedy na jeden den analýzy počítejte dva až tři dny implementace. Tento poměr se liší podle složitosti domény a zkušenosti týmu, ale dává výchozí bod pro plánování.

Commity by měly být malé a logicky členěné. Ideální je commitnout po každé dílčí změně, kterou můžete popsat jedním smysluplným větem. Vyhněte se commitům jako "oprava" nebo "dalsi zmeny". Místo toho pište konkrétně, co jste změnili a proč. Velmi praktické je držet se konvence, kde se typ změny píše na začátek, třeba "feat: přidána validace emailu" nebo "fix: oprava přetečení textu". Tato pravidla vám ušetří spoustu času při hledání, co který commit vlastně dělá.

Základní pravidla pro větve a commity Nejdůležitější je domluvit se na tom, jak budou větve vypadat. Nejčastěji se používá model, kde hlavní větev (nejčastěji master nebo main) obsahuje pouze stabilní a otestovaný kód. Veškerý vývoj probíhá na samostatných větvích, které se pojmenovávají podle úkolu, například feature/login-page nebo bugfix/oprava-prihlaseni. Každá větev by měla být krátká a měla by řešit jen jeden problém. Pokud pracujete na více věcech najednou, rozdělte si práci na menší úkoly a pro každý vytvořte samostatnou větev. Méně změn v jedné větvi znamená méně konfliktů při slučování.

Jaké konkrétní kroky podniknout? Nejprve vytvořte ve svém repozitáři složku, kam umístíte všechny konfigurační soubory. Můžete je pojmenovat například config nebo settings. barvy stěn do obýváku ní vložte soubory pro editor (např. nastavení formátování, kódování), soubory pro lintery a formátovače (např. pravidla pro syntaxi a styl), Coe-Schule.De a pokud používáte kontejnery, i soubory pro Docker Compose nebo podobné nástroje. Tento adresář by měl být verzovaný a měl by být referenčním bodem pro všechny členy týmu.

Jak se vyhnout nejčastějším začátečnickým chybám Klasická chyba je, když začnete commitovat bez rozmyšlení. Každý commit by měl být malý a logicky ucelený – měl by mít jeden účel. Jinak se v historii špatně orientuje a hledání chyby je noční můra. Také se vyhněte commitování souborů, které mají obsahovat tajné údaje (hesla, klíče). Pokud takový soubor omylem commitnete, zůstane v historii i po smazání, takže je dobré si na to dát pozor hned na začátku. Navíc si zvykněte psát smysluplné zprávy k commitům – místo „oprava" napište „oprava přihlašovací chyby při zadávání e-mailu".

Základním prvkem je popis každého endpointu. Uveďte metodu, cestu, povinné a volitelné parametry. Rozlište, co jde v URL, co v query, co v hlavičce a co v těle. Ke každému parametru patří typ, povinnost a krátký příklad. Typickou chybou je popsat jen příklad odpovědi bez toho, aby bylo jasné, co znamená. Přidejte tedy schéma odpovědi – klidně jen jako příklad JSON, ale s komentářem, který vysvětlí klíčové položky. Takový popis ušetří desítky zbytečných otázek.

Dalším krokem je verze API. V dokumentaci vždy uvádějte, pro kterou verzi popis platí. Pokud měníte chování endpointu, navrhněte změnu tak, aby starší klienti nebyli rozbití (např. pomocí rozšíření nebo nového endpointu). Typická chyba: backend změní formát data z „YYYY-MM-DD" na „DD.MM.YYYY" a frontend začne padat. Uveďte proto v dokumentaci i příklady formátů, a pokud je to možné, držte se konvencí, které frontend očekává.

Jak na udržovatelnou dokumentaci bez velké námahy Nejlepší dokumentace je ta, která se tvoří automaticky a žije s kódem. Should you have any issues concerning where along with how you can employ informace, it is possible to call us with our own website. Místo ručního psaní Markdownu zkuste generátory, které popis vytvoří z anotací byt v paneláku controlleru nebo ze schémat. Důležité je, aby se dokumentace aktualizovala při každé změně – jinak se z ní stane lež. Pokud takový nástroj zavést nemůžete, alespoň si vytvořte šablonu a doplňte popis hned při psaní endpointu, ne až na konci sprintu. Pozor na to, že dokumentace má být čitelná i pro člověka, který projekt nezná – vyhněte se interním zkratkám a slovům, která dávají smysl jen vám.