Přispějte do opensource projektu a dostanete za to (kromě dobrého pocitu) tričko. Na získání dárku máte už ale jen 14 dní! Během měsíce října totiž probíhá Hacktoberfest - projekt společností DigitalOcean a Github, který má přimět lidi něco pro OSS dělat. Abyste odměnu získali, stačí 4 (slovy: čtyři) pull requesty do opensource projektů umístěných na Githubu. A to se vyplatí.

Pokud se chcete zůčastnit, potřebujete pouze účet na Githubu, zaregistrovat se na stránce projektu a začít bušit do klávesnice. Bacha na to, že do Hacktoberfestu se počítají pouze pull requesty vytvořené právě na Githubu. Ale klidně přispějte i jinde, je to chválihodné :)

Pojďme se do toho pustit, je to fakt jednoduchý:

Git a Github

Git je nástroj pro správu verzí. Github je služba, která podporuje vývoj a sdílení softwaru za pomoci právě gitu.

Přiznávám, že jsem líný se tu o tom více rozepisovat, protože návodů, kterak používat git je asi bambilión. Takže - do hloubky jde Pro Git, který má web i v češtině. Pro rychlejší zorientování je třeba web s podtitulem no deep shit. A pak Google, že jo.

Github vezmeme zkratkou:

• po registraci si nezapomeňte nastavit SSH klíč
• forkněte si projekt, který chcete upravovat
• vytvořte lokální klon (git clone) a vlastní větev (git branch)
• upravujte a commitujte
• git push do svého forku
• a na závěr vytvořte pull request

Co, kde a jak mám upravovat?

Pokud nejste přispěvatelem do nějakého projektu, může být tento krok nejsložitější. Zkusím nabídnout pár možností:

• pokud nějaký OSS program každodenně používáte, pak víte o jeho chybách. Zkuste se na ně blíže zaměřit.
• dokumentace je jádrem každé knihovny. Chybí vám něco? Zkuste to sami doplnit.
• Github má vyhledávání. Zkuste label hacktoberfest, easyfix, apod. Umí filtrovat i podle jazyka.
• (tento web je hostovaný na githubu. Kdybyste třeba našli překladfalep... ;) )

Ještě není od věci tomu dodat trošku štábní kultury. Aby PR za něco stál, tak by měl:

• mít srozumitelný komentář
• být složený jen ze souvisejících commitů, které mají srozumitelnou commit message
• mít testy (pokud se používají)
• procházet testy
• respektovat coding style projektu
• odpovídat dalším požadavkům, které lze často najít v CONTRIBUTING souboru
• být pouze jeden (tzn. pokud plánujete změnu, použijte force push do stejné větve, neotvírejte zbytečně stejný problém vícekrát)

Kdybyste se chtěli inspirovat, tak moje PR můžete najít v projektech py3status ([1]) a asciinema ([2], [3], [4], ...)

Hodně štěstí!