BeeWare Sprints'e hoş geldiniz!
Hoş geldiniz! Bize katılmaya karar verdiğiniz için çok heyecanlıyız! Eğer daha önce Kendinizi Arı Ekibi'nden biriyle tanıştırdıysanız, lütfen bunu yapın. Bir kez Bunu yaptıysanız, başlamak için buraya geri dönün.
Sprint nedir?
Sprint, birkaç saat veya gün geçirmek için yapılandırılmamış bir fırsattır bir Açık Kaynak projesi üzerinde işbirliği içinde çalışmak. Bunlar genellikle bir konferans; bir konferanstan sonra yapılan bir sprint Bir konferansın yarattığı enerjiyi, coşkuyu ve ilgiyi dönüştürmek günlük olarak kullandığımız yazılımlarda iyileştirmeler yapmak.
Sprintler aynı zamanda insanları aşağıdaki süreçlerle tanıştırmak için bir fırsattır projeye katkıda bulunmak. Umuyoruz ki çok eğleneceksiniz sprint sırasında eve gideceğinize ve katkıda bulunmak!
Ne kadar tecrübeli olduğunuz önemli değil got. Geçmiş sprintlerde, her deneyim seviyesinden insanların katkılarını bir araya getirdik - lise öğrencileri, bootcamp'ten yeni mezun olmuş kişiler ve kendilerini programcı ve deneyimli geliştirici olarak görüyorlar. Ne olursa olsun deneyim seviyesi - katkıda bulunmanız için bir yol bulabiliriz.
Katkıda bulunmanın tek yolu kod yazmak da değildir. Gibi bir proje BeeWare koddan çok daha fazlasıdır - yazacak insanlara ihtiyacımız var, belgeleri düzeltmek ve çevirmek; belgeleri geliştirmek için insanlara ihtiyacımız var. web sayfalarının tasarımı; hatta hataların üzerinden geçme süreci Yıllar önce rapor edilmiş ve yol boyunca düzeltildikleri tespit edilmiş değerli bir katkıdır.
İlk Sorular
Başlamak için birkaç soru soracağız, böylece aşağıdakileri ölçebiliriz ilgi alanlarınız ve deneyimleriniz. Bu, aşağıdakiler için en iyi yolu bulmamıza yardımcı olacaktır katkıda bulunabilirsiniz. Sorular üzerinde çalışın, notlar alın ve ardından Arı Ekibinin bir üyesi ile görüşün ve cevaplarınızı paylaşın. Eğer anlamadıysanız sorulan soru - bu konuda endişelenmeyin! Ne sorduğunuzu bize bildirin Biliyorum ve bundan sonrasını birlikte çözmeye çalışacağız.
**Daha önce BeeWare kullandınız mı?
Eğer yapmadıysanız, BeeWare] üzerinden çalışarak başlayın. Tutorial. Bu size bir BeeWare projesinin ne olduğu ve bu projenin parçalarının nasıl proje birbirine uyuyor. Eğer herhangi bir sorunla karşılaşırsanız not alın - çünkü başka hiç kimsenin aynı eğitime sahip olmamasını sağlamak Sorun, ilk katkı için harika bir konu!
Eğitimi en az 4. adıma kadar tamamladıktan sonra Bir sonraki soru.
**Yanınızda hangi bilgisayar ekipmanı var?
Yanınızda bulunan ekipman, yapabileceklerinize pratik sınırlar koyar. katkıda bulunabilir. Örneğin, bir Windows dizüstü bilgisayarınız varsa iOS ile ilgili hiçbir şey üzerinde çalışamayacak. Senin dizüstü bilgisayar Windows, macOS, Linux veya başka bir şey mi çalıştırıyor? Telefonunuz bir iOS veya Android cihaz mı? Cihazlarınız sizin tarafınızdan mı sağlandı? işvereniniz mi, yoksa kendi kişisel cihazlarınız mı?
**Python kodu yazma konusunda ne kadar deneyiminiz var?
Programlamaya yeni mi başladınız? Bir Python emektarı mı? Bir kodlama emektarı Python öğrenmeye yeni mi başladı? Bir üniversitenin yeni mezunu bootcamp programı? Aşağıdakiler için iyi bir eşleşme olan bir sorun bulmak istiyoruz seviye deneyiminiz.
**Github katkı süreçlerine aşina mısınız?
Kodlarınızı barındırmak için GitHub (veya benzer bir kod paylaşım sitesi) kullanıyor musunuz? Kendi kodunuzu mu yazıyorsunuz yoksa başkalarının projelerine mi katkıda bulunuyorsunuz? CI'ın ne olduğunu biliyor musunuz? (sürekli entegrasyon) nedir? Bir projeye katkıda bulundunuz mu? ön taahhüt kancaları var mı? Eğer sizden "PR'ınızı ana", ne yapacağınızı biliyor musunuz?
**Daha önce bir Açık Kaynak projesine katkıda bulundunuz mu?
Geçmişte bir sprint'e katıldınız mı? Hiç PR gönderdiniz mi bir Açık Kaynak projesine (çekme isteği)? Nasıl yapıldığını biliyor musunuz Çekme isteği oluşturmak için Github'ı kullanmak için?
**Yararlı olabilecek başka özel becerileriniz var mı?
Bir GUI API'sine (Winforms, Cocoa veya GTK gibi) aşina mısınız? Belirli bir yazılımın dahili özellikleri hakkında derin bilginiz var mı? işletim sistemi? Başka bir programlama dilinde uzman mısınız? Python'dan daha mı iyi? Eğer özel bir yeteneğiniz yoksa, bu bir sorun - ama eğer elimizde bir Windows Guru varsa Bu becerilerin iyi bir şekilde kullanıldığından emin olun.
**Bize neden katıldınız ve neyle ilgileniyorsunuz?
"Dostane bir proje gibi görünüyorsunuz" gayet iyi bir cevap. Ancak, bugün bize katılma nedeniniz daha fazlaysa, bize bildirin. Mobil veya masaüstü geliştirme ile ilgileniyor musunuz? Paketleme mi? Web siteleri? Konsol uygulamaları mı? Eğer özel bir ilgi alanınız yoksa - ne BeeWare hakkında gördüklerinize dayanarak en ilginç görünen şey Uzak mı?
Şimdi, cevaplarınızı paylaşmak için Arı Ekibinin bir üyesini bulun. Şunları sorabilirler bazı takip soruları; ancak daha sonra sizi sizin de katkıda bulunabileceğiniz bir alan.
Sorununuzu Bulun
Eğer Arı Ekibinin bir üyesiyle konuştuysanız, muhtemelen size BeeWare projesinin katkıda bulunabileceğiniz bir bölümünde; onlar hatta üzerinde çalışılacak belirli bir konu önermiş olabilirler. Eğer yapmadılarsa size spesifik bir sorun olarak verildiğinde, muhtemelen sizi "İyi Bu proje için "İlk Sorunlar". Bu ne anlama geliyor?
GitHub, BeeWare'in (ve diğer üreticilerin) sorunlarının bir listesini sağlar. projeler) bildirilen tüm sorunların kaydını tutmak için - açık hataları, hata olabilecek beklenmedik davranışları içerir, yeni özellikler için talepler, daha fazla dokümantasyon için talepler - her şey BeeWare'in geliştirilebileceği bir yol olabilir. Yeni sorunlar ortaya çıktıkça rapor edildiğinde, Arı Ekibi bunlardan bazılarını iyi durumda olan sorunlar olarak işaretleyecektir. ilk kez katkıda bulunanlar için uygun - bir uzmanlık gerektirmeyen konularancak iyi tanımlanmış veya yeniden üretilmesi kolay ve muhtemelen altta yatan neden hakkında iyi bir ipucuna sahiptir. Bu sorunlar "iyi" olarak etiketlenir ilk sayı" olarak tanımlayarak daha kolay bulunmalarını sağlamıştır.
Bir GitHub sorun listesini "ilk iyi sorun" etiketine göre filtrelemek için şunları yapın bu adımlar:
- Etkinleştirmek için sorunlar listesinin üzerindeki "Etiketler" düğmesine tıklayın açılır menüsünü seçin.
- Açılır menünün üst kısmındaki arama kutusuna "good" kelimesini yazın Menü.
- Filtrelenmiş listede "iyi ilk sorun" üzerine tıklayın.
<şekil>
İlginç görünen bir sayı bulduğunuzda, herhangi bir gönderiye yorum yapın ve tartışmaya şu şekilde bir yorum gönderin sorunu araştırıyorsunuz (örneğin, "PyCon ABD'de bunu araştırıyorum 2025 sprint"). BeeWare sorunları açıkça "atamaz" - biz kabul ederiz Herkesin katkısı olabilir. Ancak, bir sprint durumunda, şunları yapmamız gerekir aynı iş üzerinde çalışan iki kişi olmadığından emin olmak için sorunu - yorum bırakmak, iki taraf arasında koordinasyon sağlamanın hafif bir yoludur. katkıda bulunanlar.
Hala yapmak istediğiniz bir şey bulamıyorsanız, bir Arı Ekibi bulun üye olun ve belirli bir sorunu daraltmanıza yardımcı olsunlar.
Bir geliştirme ortamı kurun
Bir sorun bulduğunuzda, geliştirme sürecinizi ayarlamanız gerekir ortamını kullanarak bir düzeltme üzerinde çalışabilirsiniz. Her BeeWare projesinin kendi katkı rehberi:
Proje bu listede yer almıyorsa, ayrıntılar için proje README'sini kontrol edin nasıl kurulacağı hakkında. Talimatlardan herhangi biri mantıklı gelmiyorsa (veya bu talimatları bulamazsanız), Arı Ekibinin bir üyesini bulun ve sizi çözeceklerdir. Ve - eğer iyileştirebileceğinizi düşünüyorsanız Böylece diğer insanlar da aynı sorunla karşılaşmayacak ve katki rehberi̇ değerli̇ bi̇r katki!
Artık sorununuz üzerinde çalışmaya başlayabilirsiniz!
Halkla İlişkilerimi gönderdikten sonra ne olur?
Çekme isteğinizi gönderdikten ve çekme isteği geçtikten sonra tüm otomatik kontrolleri yaptıktan sonra inceleme için hazırsınız. Çekirdekten birinin ekibi, incelemeye hazır bir halkla ilişkileriniz olduğunu bilir ve Bak.
Eğer bu sizin ilk PR'ınızsa, incelemenin bazı bulgulara ulaşması oldukça muhtemeldir. sorunlar. Bu, göz önünde bulundurmadığınız bir uç durum veya bir kod olabilir. takip etmediğiniz bir kongre. Cesaretiniz kırılmasın! Hiç kimse - değil çekirdek ekip bile - PR'ları ilk denemede %100 doğru yapar.
PR incelemeyi geçtiğinde, gözden geçireniniz PR'ı birleştirir - ve siz Tamamdır! Tebrikler - BeeWare'e katkıda bulundunuz! Eğer bu sizin ilk BeeWare katkınızı yaptığınızda, aynı zamanda BeeWare Challenge Coin - bir üye bulun çekirdek ekip, ve size bir bozuk para verecekler!
Yardım edin! Sıkıştım!
Yol boyunca herhangi bir noktada takılırsanız, bir Arı üyesi bulun Takım. Herhangi bir* soru sormaktan çekinmeyin. Eğer takılırsanız, size yardımcı olmak isteriz. sizi çözer. Kafanız karıştıysa, bunun nedeni konunun karmaşık ve biz bunu yeterince iyi açıklayamadık. Bu konuda istekliyiz. Yardım - ve başarılı bir sprint geçirdiğinizden emin olmak istiyoruz.
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!