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.
