Hatalarla Başa Çıkmak¶
Python, istikrar konusunda kendini kanıtlamış olgun bir programlama dilidir. Bu itibarı korumak için, geliştiriciler Python’da bulduğunuz eksiklikleri bilmek isterler.
Bazen hataları kendiniz düzeltmek ve değişikliklerinizi Python’a yama yaparak katkı sağlamak süreci daha az insan dahil olduğu için hızlandrabilir. Nasıl katkı sağlayacağınızı öğrenin.
Dokümantasyon hataları¶
Bu dokümantasyonda bir hata bulursanız veya bir geliştirme önermek istiyorsanız, lütfen bir hata raporu gönderin. Nasıl düzeltebileceğiniz hakkında bir öneriniz varsa, bunu da ekleyin.
Ayrıca Dokümantasyon Discourse forumumuzda bir tartışma öğesi açabilirsiniz.
If you find a bug in the theme (HTML / CSS / JavaScript) of the documentation, please submit a bug report on the python-doc-theme bug tracker.
Zamanınız kısıtlıysa, dokümantasyon hata raporlarını docs@python.org adresine de gönderebilirsiniz (davranış hataları python-list@python.org adresine gönderebilirsiniz). ‘docs@’, gönüllüler tarafından yürütülen bir posta listesidir; talebiniz fark edilecektir, ancak işlenmesi biraz zaman alabilir.
Ayrıca bakınız
- Dokümantasyon hataları
Python sorun takipçisine gönderilen dokümantasyon hatalarının listesi.
- Hata Takibi
Takipçide bir iyileştirmenin bildirilmesiyle ilgili sürece genel bakış.
- Dokümantasyona Yardım Etmek
Python dokümantasyonuna katkıda bulunmak isteyen bireyler için kapsamlı kılavuz.
- Dokümantasyon Çevirileri
Dokümantasyon çevirilerinin GitHub sayfaları ve bunların iletişim bilgilerini içeren bir liste.
Python hata takipçisini kullanmak¶
Python’un kendisi için olan hata raporları GitHub issues (https://github.com/python/cpython/issues) aracılığıyla gönderilmelidir. Hata takipçisi, ilgili bilgilerin girilmesini ve geliştiricilere gönderilmesini sağlayan bir web formu sunar.
Rapor göndermenin ilk adımı, sorunun zaten bildirilmiş olup olmadığını belirlemektir. Bunu yapmanın avantajı, geliştiricilere zaman kazandırarak, düzeltmek için neler yapıldığını öğrenmenizdir; sorun bir sonraki sürüm için zaten düzeltilmiş olabilir veya ek bilgilere ihtiyaç duyulabilir (eğer mümkünse bilgileri sağlayabilirsiniz!). Bunu yapmak için, sayfanın üst kısmındaki arama kutusunu kullanarak hata veritabanında arama yapın.
Bildirdiğiniz sorun listede değilse, GitHub’da oturum açın. Bir GitHub hesabınız, “Kayıt Ol” bağlantısına tıklayın. Hata raporunu anonim olarak göndermek mümkün değildir.
Oturum açtıktan sonra bir hata raporu gönderebilirsiniz. Yeni bir rapor oluşturmak için sayfanın üst kısmındaki “New issue” butonuna tıklayın.
Form iki kısımdan oluşur. “Başlık” ve “Yorum”.
“Başlık” için hatanın çok kısa açıklamasını girin; başlığın on kelimeden az olması iyidir.
“Yorum” alanında, ne olmasını beklediğiniz ve ne olduğu da dahil olmak üzere sorunu ayrıntılı olarak açıklayın. Herhangi bir uzantı modülünün dahil olup olmadığını, hangi donanım ve yazılım platformunu kullandığınızı (uygun sürüm bilgileri dahil) eklediğinizden emin olun.
Her hata raporu, sorunu düzeltmek için ne yapılması gerektiğini belirleyecek bir geliştiriciye atanır. Hata üzerinde her işlem başlatıldığında bir güncelleme alırsınız.
Ayrıca bakınız
- ‘Hataları Etkili Bir Şekilde Bildirmek <https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>’_
Yararlı bir hata raporunun nasıl oluşturulacağı hakkında bazı ayrıntılara giren makale. Bu makale, ne tür bilgilerin yararlı olduğunu ve neden yararlı olduğunu açıklar.
- ‘Hata Raporu Yazma Yönergeleri <https://bugzilla.mozilla.org/page.cgi?id=bug-writing.html>’_
İyi bir hata raporu yazma hakkında bilgi. Bunların bir kısmı Mozilla projesine özgüdür, ancak genel iyi uygulamaları açıklar.
Python’a kendiniz katkıda bulunmaya başlayın¶
Bulduğunuz hataları bildirmenin ötesinde, bunları düzeltmek için yamalar gönderebilirsiniz. Python’a yama yapma hakkında daha fazla bilgiyi Python Geliştirici Kılavuzu’nda bulabilirsiniz. Sorularınız varsa, core-mentorship posta listesi Python’daki sorunları çözmeyle ilgili tüm soruların yanıtlarını almak için arkadaş canlısı bir yerdir.