İçeriğe atla

Katkıda Bulun


ghostwriter'ı daha iyi yapmak istiyor musunuz? Nice katkıda bulunabileceğinizle ilgili aşağıdaki bölümleri okuyun.

Hata Raporları

Bir hata mı buldunuz? Lütfen KDE hata izleyicisinde bir hata kaydı açın. Kayıt açma yönergelerine bakmayı unutmayın! En önemlisi, kullandığınız ghostwriter sürümünü kesinlikle belirtin.

**Uyarı: Hata raporu şablonunda belirtilen tüm bilgilerin sağlanmaması durumunda, rapor kendiliğinden kapatılacaktır.

Hata Triyajı

Hata izleyicisindeki kayıtların triyajını hataları yeniden oluşturarak ve sorunun nerede olduğunu bulmak adına hata bildiricilerden daha fazla bilgi alarak yapabilirsiniz. Yinelenmiş hata kayıtlarını kapatmak ve başka türlü düzenlemeler de yine çok makbule geçecektir. Daha fazla bilgi için hata triyajı yönergelerine bakın.

Yeni Özellikler ve Hata Düzeltmeleri

Kodlamayı biliyor musunuz? Şu adımları izleyin:

  1. Özellik isteğiniz veya hata kaydınız için KDE Hata İzleyicisi üzerinde bir kayıt açın.
    Not: Bu adım, yeni özeliğin proje hedefleriyle uyuştuğunu veya hatanın gerçekten bir özellik olup olmadığının anlaşılması için gereklidir. Aynı zamanda, kodun hangi alanları ile çalışacağınızı, başkaları da aynı alanda çalışıyorsa birleştirme çakışmalarını önlemek adına koordine etmeniz gereklidir.
  2. Yeni kayıt üzerinde konuştuktan sonra özelliği veya hata düzeltmesini kodlayın. Lütfen KDE Frameworks kodlama biçemi kılavuzune uyun. Önemli: Lütfen sözü geçen hata kaydına odaklanın. Başka hata kayıtlarına ait kod değişikliklerinin ayrı kayıtlarda/birleştirme isteklerinde sunulması, kod gözden geçirmesini daha kolay kılar.
  3. Kod güncellemelerinizle birlikte ana dala karşı bir çekme isteği gönderin.
    Önemli: Çekme isteğinizi göndermeden önce işlemelerinizi git ile tıkıştırın!
  4. Kısaca bir kod gözden geçirmesini ve en az iki diğer gönüllünün özelliğinizi veya hata düzeltmenizi sınamasını bekleyin.
  5. Geri bildirim aldıkça çekme isteğinize güncellemeler yapın.
  6. Çekme isteğiniz en az iki başka gönüllü sınayıcı tarafından onaylandıktan sonra birleştirilecektir.

Kod Gözden Geçirmeleri

Kodlamayı biliyor ve ayrıntıları görmede iyi misiniz? Yeni birleştirme isteklerini gözden geçirme için gönüllü olun!

  1. Yeni birleştirme isteklerini izleyin ve gönüllü gözden geçirme yapmak istediklerinize yorumlar ekleyin.
  2. Kod gözden geçirme yorumları gönderin.
  3. (Gerekiyorsa) birleştirme isteğine istenen güncellemeleri bekleyin.
  4. Kodun düzgün olduğuna emin oluncaya dek geri bildirim sağlamayı sürdürün.
  5. Birleştirme isteğine onayınızı belirten bir yorum girin.
  6. En az iki gönüllü sınayıcı onaylarını verdiğinde, birleştirme isteği işleme alınacaktır.

Kod gözden geçirmelerinde bakmanız gereken şeyler şunlar olabilir:

  • Gönderilen kod KDE Frameworks kodlama biçemine uyuyor mu?
  • Kod okunabilir mi? Ne yaptığı zor anlaşılan satırlara yorum eklenmiş mi?
  • Kod "kötümser" mi? Bir başka deyişle, kullanmadan önce geçersiz değerleri denetliyor ve tüm olası hata durumlarını elden geçiriyor mu?
  • if ifadesindeki çoklu karşılaştırmalar ve ifadeler işlem sırası kazalarını önlemek için ayraçlarla ayrılmış mı? Örnekler:
    // Yanlış
    if (a == b || c > d);
    
    // Doğru
    if ((a == b) || (c > d));
    
  • == yazmak isterken = yazılan durumlar var mı? Örnekler:
    // Yanlış
    if (variable == 1);
    
    //         Gerekçe: Ya bir yazım yanlışı varsa? Derleyici bunu yakalayamaz!
    if (variable = 1); // Ups!
    // Doğru
    if (1 == variable);
    
    //         Gerekçe: Bu kez, derleyici yazım yanlışını yakalayacak.
    if (1 = variable); // Ups!
    

Sınama

Kod gözden geçirmesi, yeni özellikleri ve hata düzeltmelerini sınamak için gönüllü olun! Şu adımları izleyin:

  1. Yeni bir birleştirme isteği bakın ve sınamak istediğinizi belirten bir yorum ekleyin.
  2. Birleştirme isteğini platformunuzda yapın.
  3. Özelliği/Hata düzeltmesini sınayın ve onu bozmaya çalışın!
  4. Birleştirme isteğinde, sınama sonuçlarıyla ilgili olarak geri bildirim sağlayın.
  5. (Gerekiyorsa) birleştirme isteğine istenen güncellemeleri bekleyin.
  6. Kodun çalıştığından emin olana değin sınamayı sürdürün ve geri bildirim sağlayın.
  7. Birleştirme isteğine onayınızı belirten bir yorum girin.
  8. En azından başka bir gönüllü sınayıcı onayını verdiğinde, birleştirme isteği kabul edilecektir.

Çeviriler

Favori uygulamalarınızı başka dillere (örn. kendi dilinize) çevirmek için KDE çevirmenler takımına katılmayı düşünün.

Teknik Destek

macOS için yapım veya Linux üzerine bilgili misiniz? Başkalarının sürekli karşılaştığı sorunları çözmeyi biliyor musunuz? KDE hata izleyicisinde kullanıcı sorularını yanıtlamanız ve sorunları tanılamanız bize çok yardımcı olacaktır!