Průvodce sprintem

Vítejte na BeeWare Sprints!

Vítejte! Jsme moc rádi, že jste se k nám rozhodli přidat! Pokud jste se ještě jste se ještě nepředstavili někomu z týmu Bee, učiňte tak. Jakmile tak učiníte, vraťte se sem a začněte.

Co je to sprint?

Sprint je nestrukturovaná příležitost strávit několik hodin nebo dní. pracovat společně na projektu Open Source. Často jsou vázány na s konferencí; sprint po konferenci poskytuje příležitost, aby se využít energii, nadšení a zájem, které konference vyvolala. do zlepšení softwaru, který denně používáme.

Sprinty jsou také příležitostí seznámit lidi s procesem přispívat k projektu. Doufáme, že vás to bude bavit. že se budete během sprintu tak dobře bavit, že půjdete domů a budete pokračovat v práci. přispívat!

Nezáleží na tom, kolik zkušeností máte. V minulých sprintech jsme spojili příspěvky lidí se všemi úrovněmi zkušeností – studentů středních škol, čerstvých absolventů bootcampů, lidí, kteří se nepovažují za programátory, i zkušených vývojářů. Bez ohledu na vaši úroveň zkušeností – najdeme způsob, jak můžete přispět.

Kód není jediným způsobem, jak můžete přispět. Projekt jako např. BeeWare je mnohem víc než jen kód - potřebujeme lidi, kteří budou psát, a překládat dokumentaci; potřebujeme lidi, kteří by vylepšovali kód. designu webových stránek; dokonce i proces procházení chyb, které byly nahlášeny před lety, a zjišťování, zda byly opraveny v průběhu jejich řešení. je cenným přínosem.

Úvodní otázky

Pro začátek vám položíme několik otázek, abychom mohli posoudit, zda vaše zájmy a zkušenosti. To nám pomůže najít nejlepší způsob, jak jak můžete přispět. Projděte si otázky, udělejte si poznámky a pak si najděte člena včelího týmu a podělte se o své odpovědi. Pokud nerozumíte položené otázce - nedělejte si s tím starosti! Dejte nám vědět, co jste víte, a společně na to přijdeme.

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

Pokud jste tak ještě neučinili, začněte s BeeWare Tutorial. Získáte tak úvod do projektu BeeWare a dozvíte se, jak jednotlivé části projektu do sebe zapadají. Pokud narazíte na nějaké problémy při procházení tutoriálu, pořiďte si poznámky – protože zajistit, aby nikdo jiný neměl stejný problém, je skvělým tématem pro první příspěvek!

Jakmile dokončíte výukový program alespoň do kroku 4, přejděte k další otázce.

1. 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í?

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

Jste v programování nováčkem? Jste veteránem v Pythonu? Jste veteránem v programování, který se teprve začal učit Python? Jste čerstvým absolventem bootcampového programu? Chceme najít problém, který odpovídá vaší úrovni zkušeností.

1. Jste obeznámeni s procesy 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 projektů jiných? Víte, co je CI (kontinuální integrace)? Přispěli jste někdy do projektu, který má pre-commit hooky? Kdybych vás požádal, abyste „rebase svůj PR proti main“, věděli byste, co máte dělat?

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

Zúčastnili jste se někdy sprintu? Poslali jste někdy PR (pull request) do open source projektu? Víte, jak používat GitHub k vytvoření pull requestu?

1. 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 o vnitřním fungování konkrétního operačního systému? Jste odborníkem na jiný programovací jazyk než Python? Pokud nemáte žádné speciální dovednosti, není to problém – ale pokud máme k dispozici odborníka na Windows, chceme se ujistit, že jeho dovednosti budou dobře využity.

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

„Znělo to jako přátelský projekt“ je naprosto dostačující odpověď. Pokud však máte další důvody, proč jste se k nám dnes připojili, dejte nám vědět. Zajímá vás vývoj mobilních nebo desktopových aplikací? Balíčky? Webové stránky? Konzolové aplikace? Pokud nemáte konkrétní zájem – co se vám na BeeWare zdá nejzajímavější na základě toho, co jste o něm dosud viděli?

Nyní najděte člena včelího týmu, který se s vámi podělí o vaše odpovědi. Mohou se zeptat Nějaké doplňující otázky; ale pak vás nasměrují k tomu. oblasti, kde byste měli být schopni přispět.

Najděte svůj problém

Pokud jste mluvili s členem týmu Bee, pravděpodobně vás nasměroval k části projektu BeeWare, kde můžete přispět; možná vám dokonce navrhl konkrétní úkol, na kterém můžete pracovat. Pokud vám nedal konkrétní úkol, pravděpodobně vás nasměroval k „Good First Issues“ pro daný projekt. Co to znamená?

GitHub poskytuje seznam problémů, který umožňuje BeeWare (a dalším uživatelům) projektů) sledovat všechny nahlášené problémy - včetně explicitních chyb, neočekávaného chování, které možná je chybou, požadavky na nové funkce, požadavky na podrobnější dokumentaci - cokoli. co by mohlo být způsobem, jak BeeWare vylepšit. Jakmile se objeví nové problémy tým Bee označí některé z nich jako problémy, které jsou dobře řešitelné. vhodné pro začínajícího přispěvatele - problémy, které nevyžadují odbornou přípravu. *ale jsou dobře definované nebo snadno reprodukovatelné, a pravděpodobně je možné je opravit. mají dobrou stopu k příčině. Tyto problémy jsou označeny jako "dobré první problém", aby bylo snazší je najít.

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

1. Klikněte na tlačítko „Štítky“ nad seznamem problémů a aktivujte rozbalovací nabídku.
2. Do vyhledávacího pole v horní části rozbalovacího menu zadejte slovo „dobrý“.
3. Klikněte na „dobré první vydání“ ve filtrovaném seznamu.

Filtrování problémů GitHub podle štítku „good first issue“ (dobrý první problém).

Jakmile najdete zajímavé vydání, přečtěte si všechny jeho části. komentáře k příspěvku a napište do diskuse komentář, ve kterém uvedete, že že se na problém díváte (např. "Looking into this at the PyCon US"). 2025 sprintech"). BeeWare problémy výslovně "nepřiděluje" - přijímáme je. příspěvky od kohokoli. V situaci, kdy se jedná o sprint, však musíme zajistit, abychom neskončili s dvěma lidmi, kteří pracují na stejném problému. zanechání komentáře je nenáročný způsob, jak koordinovat práci mezi dvěma pracovníky. přispěvateli.

Pokud stále nemůžete najít nic, co byste chtěli dělat, najděte si tým Bee. člena a ten vám pomůže zúžit okruh problémů.

Nastavení vývojového prostředí

Po nalezení problému je třeba nastavit vývoj. prostředí, abyste mohli pracovat na opravě. Každý projekt BeeWare má vlastní příručku pro přispívání:

• Briefcase
• Toga
• Rubicon ObjC

Pokud projekt v tomto seznamu není, podívejte se do README projektu, kde najdete podrobnosti. jak jej nastavit. Pokud vám některý z pokynů nedává smysl (nebo nebo tyto pokyny nemůžete najít), vyhledejte člena týmu Bee a požádejte ho o pomoc. který vás z této situace vyvede. A - pokud si myslíte, že můžete vylepšit návod tak, aby ostatní lidé neměli stejný problém, vylepšete návod. návodu je cenným příspěvkem!

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

Co se stane po odeslání mé žádosti o trvalý pobyt?

Po odeslání požadavku na stažení a po jeho schválení je požadavek na stažení všechny automatické kontroly, jste připraveni na revizi. Nechte jednoho z hlavních týmu, že máte PR připravený k přezkoumání, a on se na něj podívá. se na něj podívají.

Pokud se jedná o vaše první PR, je dost pravděpodobné, že recenze najde nějaké nedostatky. problémy. Může jít o okrajový případ, který jste nezohlednili, nebo o kód. konvence, kterou jste nedodrželi. Nenechte se odradit! Nikdo - ne ani hlavní tým - se PR nepodaří na první pokus na 100 % opravit.

Jakmile PR projde kontrolou, váš recenzent PR sloučí – a máte hotovo! Gratulujeme – přispěli jste do BeeWare! Pokud se jedná o váš vůbec první příspěvek do BeeWare, získali jste také BeeWare Challenge Coin – najděte člena hlavního týmu a ten vám minci dá!

Pomoc! Zasekl jsem se!

Pokud se někde na cestě zaseknete, najděte si někoho ze skupiny Bee. týmu. Nebojte se položit jakoukoli otázku. Pokud jste se zasekli, chceme se vás z toho dostat. Pokud jste zmateni, je to proto, že téma je složité a my jsme ho dostatečně nevysvětlili. Jsme ochotni pomoci - a chceme se postarat o to, abyste měli úspěšný sprint.

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

Žádný problém! Příspěvek můžete zaslat kdykoli. Cílem sprintů je povzbudit vás a motivovat k tomu, abyste pokračovali v přispívání po celý zbytek roku. Tým Bee Team je vám k dispozici, aby vám pomohl s jakoukoli částí tohoto procesu.

Pokud jste již pracovali na problému GitHub nebo odeslali PR, můžete pokračovat v komunikaci prostřednictvím GitHub. Pokud máte další otázky nebo potřebujete pomoc v reálném čase, nejlépe nás najdete na BeeWare Discord serveru. 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 s tímto průvodcem sprintem se počítá jako příspěvek do BeeWare!