Sprint Kılavuzu

BeeWare Sprint'lere 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 deneyiminiz olduğu önemli değil. Geçmiş sprintlerde, lise öğrencileri, yeni mezunlar, kendilerini programcı olarak görmeyenler ve deneyimli geliştiriciler gibi her seviyeden insanın katkılarını bir araya getirdik. Deneyim seviyeniz ne olursa olsun, sizin için bir katkı yolu 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.

1. BeeWare'i daha önce kullandınız mı?

Henüz yapmadıysanız, BeeWare Öğreticisi ile çalışmaya başlayın. Bu, BeeWare projesinin ne olduğu ve projenin parçalarının nasıl bir araya geldiği konusunda size bir giriş sağlayacaktır. Öğreticiyi yaparken herhangi bir sorunla karşılaşırsanız, notlar alın - çünkü başka kimsenin aynı sorunu yaşamamasını sağlamak, ilk katkı için harika bir konudur!

En azından 4. adıma kadar öğreticiyi bitirdikten sonra, bir sonraki soruya geçin.

1. Yanınızda hangi bilgisayar ekipmanları var?

Yanınızda bulunan ekipman, katkıda bulunabileceğiniz alanları pratik olarak sınırlar. Örneğin, Windows dizüstü bilgisayarınız varsa, iOS ile ilgili hiçbir şey üzerinde çalışamazsınız. Dizüstü bilgisayarınız Windows, macOS, Linux veya başka bir işletim sistemi kullanıyor mu? Telefonunuz iOS veya Android cihaz mı? Cihazlarınız işvereniniz tarafından mı sağlandı yoksa kişisel cihazlarınız mı?

1. Python kodu yazma konusunda ne kadar deneyiminiz var?

Programlamaya yeni mi başladınız? Python konusunda deneyimli misiniz? Python öğrenmeye yeni başlayan deneyimli bir kodlayıcı mısınız? Bootcamp programından yeni mezun oldunuz mu? Deneyim seviyenize uygun bir problem bulmak istiyoruz.

1. GitHub katkı süreçlerine aşina mısınız?

Kendi kodunuzu barındırmak veya başkalarının projelerine katkıda bulunmak için GitHub (veya benzer bir kod paylaşım sitesi) kullanıyor musunuz? CI (sürekli entegrasyon) nedir biliyor musunuz? Önceden taahhüt kancaları olan bir projeye katkıda bulundunuz mu? Size "rebase ana sayfaya karşı PR'ınızı" yapmanızı istesem, ne yapmanız gerektiğini bilir misiniz?

1. Daha önce bir Açık Kaynak projesine katkıda bulundunuz mu?

Daha önce bir sprint'e katıldınız mı? Açık kaynaklı bir projeye PR (pull request) gönderdiniz mi? GitHub'ı kullanarak pull request oluşturmayı biliyor musunuz?

1. Yararlı olabilecek başka özel becerileriniz var mı?

GUI API'leri (WinForms, Cocoa veya GTK gibi) hakkında bilgi sahibi misiniz? Belirli bir işletim sisteminin iç yapısı hakkında derinlemesine bilgi sahibi misiniz? Python dışında başka bir programlama dilinde uzman mısınız? Özel bir beceriniz yoksa sorun değil, ancak Windows uzmanı bir çalışanımız varsa, bu becerilerin iyi bir şekilde kullanıldığından emin olmak isteriz.

1. Neden bize katıldınız ve nelere ilgi duyuyorsunuz?

"Siz dostane bir proje gibi geldiniz" gayet iyi bir cevap. Ancak, bugün bize katılmanızın başka nedenleri varsa, bize bildirin. Mobil veya masaüstü geliştirmeyle ilgileniyor musunuz? Paketleme? Web siteleri? Konsol uygulamaları? Belirli bir ilgi alanınız yoksa, BeeWare hakkında şimdiye kadar gördüklerinize dayanarak en ilginç gelen şey nedir?

Ş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

Bee Ekibi'nin bir üyesiyle konuştuğunuzda, muhtemelen BeeWare projesinin katkıda bulunabileceğiniz bir bölümünü size göstermişlerdir; hatta üzerinde çalışabileceğiniz belirli bir konuyu önermiş olabilirler. Size belirli bir konu vermemişlerse, muhtemelen o projenin "İyi İlk Konular" bölümünü göstermişlerdir. 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 konular ancak 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.

GitHub sorun listesini "iyi ilk sorun" etiketine göre filtrelemek için şu adımları izleyin:

1. Sorunlar listesinin üstündeki "Etiketler" düğmesine tıklayarak açılır menüyü etkinleştirin.
2. Açılır menünün üst kısmındaki arama kutusuna "iyi" kelimesini yazın.
3. Filtrelenmiş listede "iyi ilk sayı" seçeneğine tıklayın.

GitHub sorunlarını "iyi ilk sorun" etiketine göre filtreleme.

İ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.

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:

• Briefcase
• Toga
• Rubicon ObjC

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!

PR başvurumu gönderdikten sonra ne olacak?

Ç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çtikten sonra, inceleme görevlisi PR'yi birleştirecek ve işlem tamamlanmış olacak! Tebrikler, BeeWare'e katkıda bulundunuz! Bu, BeeWare'e ilk katkınızsa, BeeWare Challenge Coin ödülünü de kazandınız. Çekirdek ekipten bir üyeyi bulun, size bir madalya verecektir!

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.

Sprint sırasında katkımı tamamlayamazsam ne olur?

Sorun değil! İstediğiniz zaman katkı gönderebilirsiniz. Sprintlerin amacı, yıl boyunca katkı sağlamaya devam etmenizi teşvik etmek ve size bu konuda destek olmaktır. Bee Ekibi, bu sürecin her aşamasında size yardımcı olmaya hazırdır.

Zaten bir GitHub sorunu üzerinde çalışıyorsanız veya bir PR gönderdiyseniz, GitHub üzerinden iletişim kurmaya devam edebilirsiniz. Başka sorularınız varsa veya gerçek zamanlı yardıma ihtiyacınız varsa, bizi bulabileceğiniz en iyi yer BeeWare Discord sunucusu'dur. Sizinle çalışmaya devam etmeyi dört gözle bekliyoruz!

Bu kılavuzu iyileştirme

Bu sprint rehberini nasıl geliştirebileceğimize dair önerileriniz varsa, bize bildirin. Sizin için ne işe yaradı? Ne işe yaramadı? Neyi daha iyi yapabiliriz? Ve unutmayın: bir hatayı düzeltmek Bu Sprint Kılavuzu ile ilgili sorun, BeeWare'e bir katkı olarak sayılır!