Jak psát dokumentaci API, aby frontend a backend spolupracovaly
Učte se postupně. Začněte s nadpisy od h1 po h6, odstavci, seznamy a odkazy. Poté přidejte obrázky a tabulky. U každého prvku si všímejte, jak se chová v prohlížeči. Nejdůležitější je pochopit, že každý element je vlastně obdélník – má šířku, výšku, okraje a vnitřní odsazení. CSS vlastnosti jako margin, padding a border vám dají plnou kontrolu nad tímto rozložením.<br>
<br>
<br>
<br>
Prvním krokem je inicializace projektu. Ve složce, kde máte zdrojové soubory webu, otevřete terminál a spustíte příkaz pro vytvoření nového repozitáře. Tím se vytvoří skrytá složka, do které se ukládají metadata o změnách. Důležité je vědět, že verzovat byste měli pouze zdrojové soubory – HTML, CSS, JavaScript a podobně. Vygenerované soubory, jako jsou minifikované skripty nebo nahrané obrázky, do verzování nepatří, protože je lze kdykoliv znovu vytvořit. K tomuto účelu slouží soubor s ignorovanými položkami, do kterého zapíšete seznam souborů a složek, které se mají přeskočit.<br>
<br>
<br>
<br>
Na závěr si řekněme, čemu se vyhnout. Nikdy necommitujte citlivé údaje, jako jsou hesla, API klíče nebo přihlašovací údaje. I když později soubor smažete, historie commitu ho stále obsahuje. Pokud se tak stane, je nutné přepsat historii, což je pro začátečníka složité. Dále se vyhněte commitování velkých binárních souborů, pokud to není nezbytně nutné – repozitář se tím rychle nafoukne a zpomalí. A hlavně: verzování není jen o ukládání změn, ale o přemýšlení nad tím, co děláte. Pravidelný a smysluplný commit vám dá jistotu a svobodu tvořit bez strachu, že něco rozbijete.<br>
<br>
<br>
<br>
Druhým krokem je vytvoření vlastního portfolia. Nemusíte mít přístup k placeným nástrojům – postačí vám bezplatné aplikace, které dobře znáte, nebo dokonce vlastní malý projekt. Vyberte si jednoduchou webovou stránku nebo mobilní aplikaci a začněte ji systematicky testovat. Zapisujte si každý nález do tabulky: popište krok, jakým jste problém reprodukovali, očekávané chování, skutečné chování a případně i prioritu. Dbejte na to, aby váš popis byl srozumitelný i pro člověka, který aplikaci nezná. Tento dokument pak poslouží jako ukázka vaší práce při pohovoru. Častým omylem je testování pouze „šťastné cesty" – tedy že vše funguje, když uživatel postupuje správně. Zkuste se zaměřit na okrajové případy, prázdná pole, nezvyklé vstupy nebo přerušení připojení.<br>
<br>
<br>
<br>
Pro první pokus stačí obyčejný textový editor a prohlížeč. Vytvořte soubor s příponou .html a do něj napište základní kostru: doctype, html, head a body. Do hlavičky patří meta informace a titulek stránky, do těla pak samotný obsah. Propojení s CSS provedete buď stylem přímo v hlavičce, nebo lépe externím souborem s příponou .css, který připojíte odkazem. Mnoho začátečníků dělá chybu, že všechny styly píší do HTML, ale to se při větším projektu stává nepřehledné.<br>
<br>
<br>
<br>
Jak se dostat k prvnímu projektu, když nemáte zkušenosti Když máte portfolio, je čas hledat první příležitost. Můžete se zapojit do open-source projektů, kde vývojáři často vítají pomoc s testováním. Stačí si vybrat projekt, který vás zajímá, a podívat se, zda nemá sekci pro hlášení chyb. Začněte s menšími úkoly, jako je reprodukce nahlášeného problému nebo testování nové funkce. Pozor si dejte na to, abyste nejprve prostudovali pokyny projektu a komunikovali s komunitou slušně. Další možností je nabídnout své služby malým firmám nebo živnostníkům, kteří mají webové stránky nebo eshop a nemají vlastní testery. Můžete jim nabídnout jednorázový testovací cyklus za symbolickou odměnu nebo zdarma – hlavně kvůli zkušenosti. Vyhněte se ale práci zcela zadarmo pro velké korporace, které by vaši práci mohly využít bez jakékoli protislužby.<br>
<br>
<br>
<br>
Při psaní životopisu a motivačního dopisu se nesoustřeďte na to, co neumíte, ale na to, co jste se naučili a jak jste to aplikovali. Uvádějte konkrétní příklady z vašeho portfolia: „Na testování webové aplikace jsem našel 12 chyb, z toho 5 kritických." Nebojte se zmínit, že používáte nástroje jako jsou vývojářské nástroje v prohlížeči, nebo že umíte založit bug report v systému pro sledování chyb. Typickou chybou začátečníků je uvádět v životopise „základní znalost SQL" nebo „znalost testovacích nástrojů" bez jakékoli konkrétní zkušenosti. Raději než seznam technologií uveďte, jak jste je použili v praxi. Zkuste si také nacvičit odpovědi na otázky týkající se testovacích technik, jako je ekvivalentní rozdělení nebo analýza hraničních hodnot – personalisté je často zkouší.<br>
<br>
<br>
<br>
Dalším praktickým krokem je zapojení do komunitních aktivit, jako jsou online workshopy, webináře nebo místní srazy testerů. I když nemáte praxi, můžete se ptát, sdílet své poznatky a navazovat kontakty. Mnoho lidí získá první práci právě díky doporučení od někoho, koho potkali na takové akci. Nebojte se nabídnout pomoc s testováním menším firmám nebo neziskovým organizacím – často ocení dobrovolníka, který jim pomůže zlepšit kvalitu jejich produktu.