Průvodce sprintem¶

Vítejte na sprintech BeeWare!¶

Vítejte! Máme velkou radost, že jste se rozhodli přidat. Jestli jste se ještě nepředstavili některému členovi týmu Bee, udělejte to prosím. Potom se vraťte sem a začněte.

Co je to sprint?¶

Sprint je neformální příležitost strávit několik hodin či dní společnou prací na projektu s otevřeným zdrojovým kódem. Často navazuje na konferenci; umožňuje proměnit energii, nadšení a zájem, které konference vyvolala, ve zlepšení softwaru, který denně používáme.

Sprint je také příležitostí seznámit se s postupem, jak do projektu přispívat. Doufáme, že vás přispívání během sprintu bude bavit natolik, že v něm budete pokračovat i po návratu domů!

Nezáleží na tom, kolik máte zkušeností. Na minulých sprintech jsme začlenili příspěvky lidí všech úrovní zkušeností – středoškoláků, čerstvých absolventů bootcampů, lidí, kteří se nepovažují za programátory, i zkušených vývojářů. Ať už máte zkušeností kolikoli, najdeme způsob, jak můžete přispět.

Přispívat lze i jinak než kódem. Projekt jako BeeWare je mnohem víc než jen kód: potřebujeme lidi, kteří budou psát, korigovat a překládat dokumentaci i zlepšovat design webových stránek. Cenným příspěvkem je také procházení dříve nahlášených chyb a ověřování, zda už byly opraveny.

Úvodní otázky¶

Na úvod vám položíme několik otázek, abychom mohli zjistit vaše zájmy a zkušenosti. Pomůže nám to najít nejlepší způsob, jak můžete přispět. Projděte si otázky, udělejte si poznámky a pak najděte člena Týmu BeeWare a podělte se s ním o své odpovědi. Pokud položené otázce nerozumíte, nedělejte si s tím starosti! Řekněte nám, co víte, a společně přijdeme na to ostatní.

Už jste někdy používali BeeWare?

Pokud ne, začněte tím, že projdete BeeWare Tutorial. Seznámí vás s projektem BeeWare a s tím, jak do sebe jeho části zapadají. Narazíte-li při procházení výukového programu na problém, dělejte si poznámky — zajistit, aby stejný problém nepotkal nikoho dalšího, je skvělé téma pro první příspěvek!

Až projdete výukový program alespoň ke kroku 4, přejděte k další otázce.

Jaké počítačové vybavení máte s sebou?

Vybavení, které máte k dispozici, prakticky omezuje to, na čem můžete pracovat. Pokud máte například notebook s Windows, nebudete moci pracovat na ničem, co souvisí s iOS. Běží váš notebook na Windows, macOS, Linuxu nebo jiném operačním systému? Máte telefon s iOS nebo Androidem? Byla vám zařízení poskytnuta zaměstnavatelem, nebo se jedná o vaše osobní zařízení?

Jaké máte zkušenosti s psaním kódu v jazyce Python?

Jste začátečník v programování? Ostřílený programátor v Pythonu? Ostřílený programátor, který se Python teprve učí? Čerstvý absolvent bootcampu? Chceme najít problém, který odpovídá vašim zkušenostem.

Znáte postupy přispívání na GitHubu?

Používáte GitHub (nebo podobný web pro sdílení kódu) k hostování vlastního kódu nebo k přispívání do cizích projektů? Víte, co je CI (kontinuální integrace)? Přispěli jste do projektu s hooky pre-commit? Kdybych vás požádal, abyste provedli rebase svého pull requestu na main, věděli byste, co dělat?

Přispěli jste již někdy do open source projektu?

Zúčastnili jste se už někdy sprintu? Odeslali jste někdy pull request do open-source projektu? Víte, jak pomocí GitHubu vytvořit pull request?

Máte nějaké další speciální dovednosti, které by mohly být užitečné?

Znáte GUI API (například WinForms, Cocoa nebo GTK)? Máte hluboké znalosti vnitřní architektury určitého operačního systému? Jste odborníkem na jiný programovací jazyk než Python? Pokud nemáte žádné zvláštní dovednosti, vůbec to nevadí — máme-li mezi sebou experta na Windows, chceme se ujistit, že jeho dovednosti dobře využijeme.

Proč jste se k nám připojili a co vás zajímá?

„Znělo to jako přátelský projekt“ je naprosto přijatelná odpověď. Pokud máte i další důvody, proč jste se k nám dnes připojili, dejte nám vědět. Zajímá vás vývoj pro mobilní zařízení nebo stolní počítače? Balíčkování? Weby? Konzolové aplikace? Pokud nemáte konkrétní zájem, co vás podle toho, co jste o BeeWare zatím viděli, zaujalo nejvíc?

Teď najděte člena Týmu BeeWare, se kterým můžete sdílet své odpovědi. Možná položí několik doplňujících otázek, pak vás ale nasměruje do oblasti, kde byste mohli přispět.

Najděte vhodný problém¶

Pokud jste mluvili s členem Týmu BeeWare, nejspíš vás nasměroval k části projektu, do které můžete přispět; možná vám dokonce navrhl konkrétní problém, na němž byste mohli pracovat. Pokud vám neurčil konkrétní problém, nejspíš vás odkázal na „Good First Issues“ daného projektu. Co to znamená?

GitHub nabízí seznam problémů, který BeeWare i dalším projektům umožňuje sledovat všechny nahlášené potíže — od jednoznačných chyb přes neočekávané chování, jež může být chybou, požadavky na nové funkce a další dokumentaci až po cokoli, čím lze BeeWare vylepšit. Když jsou nahlášeny nové problémy, Tým BeeWare některé z nich označí jako vhodné pro začínající přispěvatele: nevyžadují okamžitou opravu, jsou však dobře vymezené nebo je lze snadno reprodukovat a pravděpodobně nabízejí dobré vodítko k základní příčině. Aby je bylo snazší najít, jsou tyto problémy označeny štítkem „good first issue“.

Chcete-li seznam problémů na GitHubu filtrovat podle štítku „good first issue“, postupujte takto:

Kliknutím na tlačítko „Štítky“ nad seznamem problémů otevřete rozevírací nabídku.
Do vyhledávacího pole v horní části rozevírací nabídky zadejte slovo „good“.
V filtrovaném seznamu klikněte na „good first issue“.

Filtrování problémů na GitHubu podle štítku „good first issue“.

Jakmile najdete zajímavý problém, přečtěte si komentáře u příspěvku a v diskusi napište, že se jím zabýváte (např. „Zabývám se tím v rámci sprintů na PyCon US 2026“). BeeWare problémy výslovně „nepřiděluje“ – přijímáme příspěvky od kohokoli. V rámci sprintu však musíme zajistit, aby na stejném problému nepracovali dva lidé; zanechání komentáře je nenáročný způsob koordinace mezi přispěvateli.

Pokud stále nemůžete najít nic, na čem byste chtěli pracovat, najděte člena Týmu BeeWare; pomůže vám zúžit výběr na konkrétní problém.

Nastavte vývojové prostředí¶

Jakmile najdete problém, budete si muset připravit vývojové prostředí, abyste mohli pracovat na opravě. Každý projekt BeeWare má vlastní příručku pro přispěvatele:

Pokud projekt v tomto seznamu není, podívejte se do jeho README, kde najdete podrobnosti o přípravě prostředí. Jestliže vám některý pokyn nedává smysl (nebo jej nemůžete najít), obraťte se na člena Týmu BeeWare — pomůže vám dál. A pokud si myslíte, že lze pokyny vylepšit tak, aby se ostatní nesetkali se stejným problémem, je vylepšení příručky pro přispěvatele cenným příspěvkem!

Nyní můžete začít pracovat na svém problému!

Co se stane po odeslání mého pull requestu?¶

Jakmile pull request odešlete a projde všemi automatickými kontrolami, je připraven k revizi. Dejte někomu z hlavního týmu vědět, že máte pull request připravený k revizi, a podívá se na něj.

Pokud je to váš první pull request, je velmi pravděpodobné, že revize odhalí několik problémů. Může jít o okrajový případ, který vás nenapadl, nebo o nedodrženou konvenci kódu. Nenechte se odradit! Nikomu — ani hlavnímu týmu — se nepodaří udělat pull request na první pokus stoprocentně správně.

Jakmile pull request projde revizí, jeho recenzent jej sloučí — a máte hotovo! Gratulujeme, přispěli jste k BeeWare! Pokud jde o váš úplně první příspěvek do BeeWare, zasloužili jste si také pamětní minci BeeWare — najděte člena hlavního týmu a dá vám ji!

Pomoc! Nemůžu se pohnout dál!¶

Pokud se kdykoli zaseknete, najděte člena Týmu BeeWare. Nebojte se položit jakoukoli otázku. Když se zaseknete, chceme vám pomoci dál. Pokud jste zmatení, je to proto, že téma je složité a my jsme ho nevysvětlili dost dobře. Rádi pomůžeme — chceme, aby pro vás sprint dopadl dobře.

Co se stane, pokud svůj příspěvek během sprintu nedokončím?¶

Žádný problém! Příspěvek můžete odeslat kdykoli. Cílem sprintů je povzbudit vás a podpořit, abyste přispívali i po zbytek roku. Tým BeeWare vám pomůže s jakoukoli částí tohoto procesu.

Pokud už pracujete na problému na GitHubu nebo jste odeslali pull request, můžete dál komunikovat přes GitHub. Máte-li další otázky nebo potřebujete pomoc v reálném čase, nejlépe nás zastihnete na serveru BeeWare na Discordu. Těšíme se na další spolupráci s vámi!

Vylepšení tohoto průvodce¶

Pokud máte nějaké návrhy na vylepšení tohoto průvodce sprintem, dejte nám vědět. Co se vám osvědčilo? Co nefungovalo? Co můžeme udělat lépe? A nezapomeňte: oprava problému v tomto průvodci sprintem je příspěvkem do BeeWare!