GitHub prakticky

GitHub je webová služba podporující vývoj softwaru za pomoci verzovacího nástroje Git, lze ji však použít i jako systém pro verzování souborů nebo místo pro týmovou spolupráci.

Ač je prostředí GitHubu vcelku intuitivní, může anglicky nehovořícím nováčkům činit potíže. Obzvlášť těm je určen tento text.

Založení účtu

• v prohlížeči otevřít domovskou stránku GitHubu
• vpravo nahoře kliknout na poslední tlačítko "Sign Up" (předchozí "Sing In" je pro ty, co již účet mají)
• zobrazí se průvodce, kde
  1. v prvím kroku je třeba ve formuláři vyplnit:
     • Uživatelské jméno (Username) - objeví-li se červený vykřičník, je již obsazeno a musíte si zvolit jiné
     • E-mailovou adresu (Email address) - bude na něj zaslána ověřovací zpráva
     • Heslo (Password) - minimálně osm znaků z nichž jedno musí být číslice
     • a kliknout dole na zelené tlačítko "Create an account"
  2. v druhém kroku volíte balíček. Nejsnáze
     • ponechat předvolený bezplatný "Free" ($0)
     • nezaškrtávat položky "Help me set up an organization next" a "Send me updates on GitHub news, offers, and events"
     • a kliknout na zelené "Continue"
  3. v třetím kroku se zjišťují vaše zkušenosti a důvody použití GitHubu. Nejsnáze
     • nic nevyplňovat a kliknout na zelené "Submit"
• v tuto chvíli je účet vytvořen a vy si pomocí tlačítek můžete z mnoha možností zvolit, co dál. Například:
  • "Read the guide" - provede vás použitím GitHubu
  • "Start a project" - vytvoří nový vámi vlastněný projekt (ovšem až po ověření e-mailu)
  • "Explore GitHub" - umožní vám prohlížet si GitHub, ale již jako příhlášený uživatel
  • nebo stránku zavřít
• proces registrace končí ověřením e-mailu tzn. otevřít svou e-mailouv schránku a v ní zprávu pojmenovanou "[GitHub] Please verify your email address.". Je potřeba
  • kliknout na modré tlačítko "Verify email address"
  • zobrazí se opět stránka GitHubu, kde vlevo nahoře uvidíte "Your email was verified."
• Hotovo!

Zadání podnětu

se vztahuje vždy k určitému projektu (repozitáři) a používá se pro nahlášení chyby, zapsání podnětu či poskytnutí jiné zpětné vazby. Má tyto kroky:

• na GitHubu zcela vlevo nahoře zapsat název hledaného projektu, např. "otevrene-formalni-normy" a potvrdit Entrem
• v sezamu výsledků kliknout na nejlépe odpovídající např. opendata-mvcr/otevrene-formalni-normy
• v horní části pod názvem projektu (repozitáře) kliknout na kartu "Issues"
• a nasledně pak na zelené tlačítko "New issue"
• na zobrazeném formuláři je třeba vyplnit
  • titulek/název požadavku. Měl by být stručný a výstižný podobně jako položka "Předmět" při psaní e-mailů
  • popis požadavku dostatečný pro pochopení vašeho sdělení
    • je dobré myslet na snadnou dohledatelnost pro čtenáře např. doplnit odkaz hlásíte-li chybu na webové stránce
  • kliknout dole na zelené tlačítko "Submit new issue"
• Hotovo!