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ı¶
If you find a bug in this documentation or would like to propose an improvement, please submit a bug report on the issue tracker. If you have a suggestion on how to fix it, include that as well.
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 issue tracker.
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.