Mevcut belgelendirmeye katkıda bulunma

Bu bölüm mevcut, yani web sitesinde zaten yayınlanmış olan belgelendirmeye nasıl katkıda bulunulacağını açıklamaktadır. Bu işleme başlamadan önce Ön koşullar bölümünde listelenen tüm gereksinimleri karşıladığınızdan emin olun.

Her Fedora Belgeler sayfasının üst kısmında bir "Bu Sayfayı Düzenle" bağlantısı bulunmaktadır. Basit güncellemeler için, değişiklikler doğrudan Pagure web arayüzünden gönderilebilir. Daha büyük veya daha karmaşık düzenlemeler için, göndermeden önce değişikliklerinizi çevrim dışı hazırlamalı ve test etmelisiniz.

Pagure’de çevrim içi düzenleme

  1. Belgelendirme kaynağını yüklemek için "Bu Sayfayı Düzenle" bağlantısına tıklayın. Pagure’deki ilgili içerik deposuna yönlendirileceksiniz.

  2. Sağ taraftaki kaynak listesinin üzerinde "Fork and Edit" düğmesine tıklayın. (Deponun zaten bir çatalını oluşturduysanız, bu düğme "Edit in your fork" olarak etiketlenecektir, bir sonraki adıma geçebilirsiniz.)

    1. Pagure’de henüz oturum açmadıysanız, kimlik bilgileriniz istenecektir.

    2. İşlemin bitmesini bekleyin. İşlem tamamlandığında her zaman otomatik olarak güncellenmediğinden sayfayı yenilemeniz gerekebilir.

  3. Dosya çatalınıza yüklendikten sonra, içerikte gerekli değişiklikleri yapın, bunları çatalınıza işleyin ve bir çekme talebi (pull request - PR) hazırlayın.

    1. Her PR, deponuzdaki kendi dalından gönderilmelidir. İşlem (commit) arayüzünün "Branch" başlığı altında, "New branch" seçeneğini seçin ve dala kısa, benzersiz bir ad verin.

    2. Kayıt mesajı formunu doldurun.

    3. Dalı oluşturmak ve bu değişiklikleri çatalınıza kaydetmek için "Commit changes" düğmesine tıklayın.

  4. Değişiklikler kaydedildikten sonra, sayfa çatalınız için bir işlemler listesine yenilenecektir.

  5. İlave, ilgili değişiklikler eklemek için bu işlemi tekrarlayın ve aynı dala kaydedin.

  6. Hazır olduğunuzda, "Create pull request" düğmesine tıklayın ve dalınızı upstream deposuna göndermek için PR formunu doldurun.

Git kayıt (commit) ipuçları
  • Dalınızı adlandırırken, sadece ASCII harfleri, rakamlar, tire (-) ve alt çizgi (_) karakterlerini kullanın. Ad tek noktalar (.) içerebilir, ama onlarla başlayamaz veya bitemez. Boşluklar, çift noktalar (..), ve diğer noktalama işaretlerinin çoğuna izin verilmez.

  • Kayıt başlığı, düzenlemenizin sayfanın depo günlüğünde nasıl tanımlanacağıdır. Önerilen başlık, "Update pathname", küçük düzenlemeler için yeterlidir. İyi kayıt mesajları yazma konusunda bazı tavsiyeler için, Tim Pope (vim yazarı) tarafından hazırlanan commit.style sayfasına bakın.

  • Gerekirse ek ayrıntı sağlamak için "Commit Description" alanını kullanın, ancak kısa tutun. Çekme isteğinizi gönderdiğinizde değişikliklerinizi açıklama veya tartışma fırsatınız olacaktır.

Çevrim dışı düzenleme

  1. Belgelendirme kaynağını yüklemek için "Bu Sayfayı Düzenle" bağlantısına tıklayın. Pagure’deki ilgili içerik deposuna yönlendirileceksiniz. Doğru depoyu bulduğunuzda, daha önce yapmadıysanız bir çatalını oluşturun:

    1. Sağ üst köşedeki "Fork" düğmesine tıklayın.

    2. Pagure’de henüz oturum açmadıysanız, kimlik bilgileriniz istenecektir.

    3. İşlemin bitmesini bekleyin. İşlem tamamlandığında her zaman otomatik olarak güncellenmediğinden sayfayı yenilemeniz gerekebilir.

    4. Çatalınızı klonlayın.

  2. Yeni bir dal (branch) oluşturun ve değişikliklerinizi yapın.

  3. Herhangi bir yeni dosya eklediyseniz, bunların deponun nav.adoc yapılandırma dosyasında makul bir yere dahil edildiğinden emin olun

  4. Yerel olarak oluşturun ve her şeyin beklediğiniz gibi göründüğünden emin olun. Talimatlar için Yerel ön izleme oluşturma sayfasına bakın.

  5. İşiniz bittiğinde, değişikliklerinizi kaydedin ve bunları çatalınıza gönderin (commit & push).

  6. Çatalınızdan ana deponun master dalına bir çekme isteği (pull request) yapmak için Pagure’yi kullanın.

Çekme isteğinizi yönetme

Birisi çekme isteğinizi görecek ve birleştirecek ya da değiştirmeniz gereken bir şey varsa geri bildirim sağlayacaktır. Yaptığınız katkıların standartlara uygun olduğundan emin olmak için yorum yapan kişilerle uyumlu çalışın.

Birkaç gün içinde hiç kimse çekme isteğinize cevap vermezse, haftalık toplantılarda, IRC kanalında (FreeNode üzerinde #fedora-docs), veya e-posta listesinde gündeme getirmeyi deneyin.

Değişiklikleriniz, çekme isteği birleştirildikten bir süre sonra çevrim içi olarak görülecektir. Site günlük olarak güncellenmektedir. Değişiklikleriniz çekme isteğinizin birleştirilmesinden sonraki 60 saat içinde çevrim içi olarak görünmüyorsa, IRC kanalında asamalik (Adam Šamalík)'e mesaj atın ve sorun.