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 máte zkušeností. máte. Na minulých sprintech, jsme sloučili příspěvky od lidí na všech úrovních zkušeností - středoškoláci, čerství absolventi bootcampů, lidé, kteří nemají žádné zkušenosti. se nepovažují za programátory, a zkušené vývojáře. Nezáleží na tom, jakou máte zkušenostech - 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.
Používali jste již někdy BeeWare?
Pokud jste to ještě neudělali, začněte tím, že si projdete BeeWare Tutorial. Ten vám poskytne Co je projekt BeeWare a jak se jednotlivé části projektu používají. do sebe jednotlivé části projektu zapadají. Pokud narazíte na nějaké problémy při provádění tutoriálu, udělejte si poznámky - protože zajistíte, že nikdo jiný nebude mít stejné problémy. problém, je skvělé téma pro první příspěvek!
Jakmile dokončíte výukový program alespoň do kroku 4, přejděte na stránku. na další otázku.
Jaké počítačové vybavení máte s sebou?
Vybavení, které máte s sebou, prakticky omezuje to, co můžete dělat. můžete přispět. Například pokud máte notebook se systémem Windows. nebudete moci pracovat na ničem, co souvisí se systémem iOS. Má váš notebooku běží systém Windows, macOS, Linux nebo něco jiného? Je váš telefon zařízení se systémem iOS nebo Android? Bylo vaše zařízení poskytnuto zaměstnavatel, nebo jsou to vaše osobní zařízení?
Kolik máte zkušeností s psaním kódu v jazyce Python?
Jste v programování nováčkem? Jste veteránem Pythonu? Veterán v programování, který se teprve začal učit Python? Jste čerstvým absolventem programu bootcamp? Chceme najít problém, který se hodí pro vaší úrovni zkušeností.
Jste obeznámeni s procesy přispívání na Githubu?
Používáte GitHub (nebo podobný web pro sdílení kódu) pro hostování svých dat? vlastní kód nebo přispíváte do cizích projektů? Víte, co je CI (continuous integration)? Přispěli jste do projektu, který má háčky před odesláním? Kdybych vás požádal, abyste "přepsali svůj PR proti main", věděli byste, co máte dělat?
Přispěli jste již někdy do projektu s otevřeným zdrojovým kódem?
Zúčastnili jste se v minulosti sprintu? Podali jste někdy PR (pull request) k projektu Open Source? Jste obeznámeni s tím, jak používat Github k vytvoření žádosti o stažení?
Máte nějaké další speciální dovednosti, které by se vám mohly hodit?
Znáte rozhraní GUI (například Winforms, Cocoa nebo GTK)? Máte hluboké znalosti o vnitřnostech konkrétního systému? operačního systému? Jste odborníkem v jiném programovacím jazyce? než Python? Pokud nemáte žádné speciální dovednosti, není to na závadu. ale pokud máme v rukou guru systému Windows, chceme, abyste se o ně zajímali. ujistit, že tyto dovednosti budou dobře využity.
Proč jste se k nám přidal a co vás zajímá?
"Zněl jste jako přátelský projekt" je naprosto v pořádku. Pokud však existuje něco víc, proč jste se k nám dnes připojili, dejte nám vědět. Zajímáte se o vývoj mobilních nebo desktopových aplikací? Balení? Webové stránky? Konzolové aplikace? Pokud nemáte specifický zájem - jaký? se vám zdá nejzajímavější na základě toho, co jste o BeeWare zatím viděli. zatím?
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 některým členem včelího týmu, pravděpodobně vás upozornil na to. na část projektu BeeWare, kde můžete přispět. možná dokonce navrhli konkrétní problém, na kterém byste mohli pracovat. Pokud to neudělali vám nedali konkrétní problém, pravděpodobně vás odkázali na "Dobrý projekt". První problémy" 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ů GitHubu podle štítku "dobrý první problém", postupujte takto. následující kroky:
- Klepnutím na tlačítko "Štítky" nad seznamem vydání aktivujete. rozbalovací nabídku.
- Do vyhledávacího pole v horní části rozevírací nabídky zadejte slovo "good" (dobrý). nabídky.
- Ve filtrovaném seznamu klikněte na položku "good first issue".
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í:
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é PR?
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 ji sloučí - a vy jste hotovo! Gratulujeme - přispěli jste do BeeWare! Pokud je to váš první příspěvek do BeeWare, získali jste také svůj BeeWare Challenge Coin - najděte člena skupiny hlavního týmu a ten vám minci dá!
Pomoc! Zasekla 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.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!