Nasıl katkı yapabilirim?

Merhaba

Cloud Native Sözlüğü katkı rehberine hoşgeldiniz. İlginiz için teşekkür ederiz. Detaylıca anlatacağımız şekilde, katkı yapmanın birkaç yolu var:

1. Mevcut bir issue üzerinde çalışma
2. Yeni terimler önerme
3. Mevcut terimleri güncelleme
4. Sözlüğü kendi dilinize çevirme

Cloud Native Sözlüğü’ne genel bakış

Bu sözlüğün amacı, karmaşıklığı ile ünlü olan Cloud Native alanını sadeleştirmek ve herkese daha erişilebilir hale getirmektir.

Cloud Native Sözlüğü’nün içeriğinin tutulduğu bu GitHub repository‘sinde, sözlük hakkında issue’lar, pull request’ler (PRs) ve tartışmalar bulabilirsiniz.

Kimler katkı yapabilir?

Nasıl katkıda bulunabileceğiniz, Cloud Native alanındaki bilgi seviyenize bağlıdır. Karmaşık kavramları sadeleştirmek, konu hakkında oldukça derin bir bilgi seviyesi gerektirir. Dolayısıyla, yeni terimler önermek için o terimler hakkında uzman olmanız gerekir. Katkı yapanlar genellikle bu teknolojilerle bir süre çalışmış olan mühendisler veya Cloud Native’e odaklanmış akademisyenlerdir.

Karmaşık kavramları sade kelimeler ile açıklamak gerçekten çok zor olduğu için, bu bilgi birikimi gereklidir. Ayrıca, kolay anlaşılabilir ve kullanıcı dostu sonuçlar elde etmek kolay gibi görünse de, arzu edilen sadelik ancak Cloud Native uzmanlarının sıkı çalışması ve işbirliği ile başarılabilir.

Eğer bir Cloud Native uzmanı değilseniz fakat katkıda bulunmak istiyorsanız, bir uzmanla takım olmanızı tavsiye ederiz. Uzman, terimin kavramı tam olarak tarif ettiğinden emin olduğunda, ilk Sözlük katkınıza hazırsınız demektir.

Başka bir dilde yeterliliğe sahip olan kişiler, yerelleştirme çabalarına katılarak Sözlük’e değerli katkı yapabilirler. Bu yeni başlayanlar için de uygundur. İngilizce’deki oturmuş tanımlar ile, daha az tecrübeli kişiler başka bir dile yerelleştirme yapabilirler. Siz de, mevcut olan yerelleştirme takımlarına katılabilir veya yeni bir tane başlatabilirsiniz. Bu rehberin “Sözlüğü yerelleştirmemize yardım edin” kısmını okuyarak nasıl başlayacağınızı öğrenebilirsiniz.

Türkçe yerelleştirme ekibi

Türkçe yerelleştirme ekibi olarak katkılarınızı bekliyoruz!

Ekibimiz herkesin katılımına açık.

Türkçe yerelleştirme ekibi olarak her türden katılımcıya yönelik görevlerimiz bulunmakta.

CNCF Sözlüğü yerelleştirmesine yardımcı olarak:

• Açık kaynağa katkı yapmak için iyi bir başlangıç şansı edebilirsiniz. Açık kaynak katkı süreçlerine giriş yapıp, topluluk işleyişi hakkında fikir sahibi olabilirsiniz.
• Türkiye’den başka Cloud Native ile ilgilenen kişiler ile bağlantı kurabilirsiniz.
• CNCF topluluğu hakkında fikir edinebilirsiniz.
• Türk yazılım ve teknoloji topluluğuna fayda sağlayabilirsiniz.

Ekibimiz şeffaf ve açık bir şekilde çalışmakta.

Katılmak için bize CNCF Slack’inde, #glossary-localization-turkish kanalında selam verebilir ve katılım talimatlarını görebilirsiniz.

Başlamadan Önce

Sözlük katkı serüveninize başlamadan önce, aşağıdaki adımları tamamladığınızdan emin olun:

1. Eğer yoksa, Bir GitHub hesabı oluşturun.
2. Katılımcı Lisans Sözleşmesini (Contributor License Agreement - CLA) imzalayın.
3. Commit imzanızı doğrulayın
4. Commit’lerinizde “Onaylandı” göstergesini göstermek için GitHub hesabınızda farkındalık modunu açın.

Örnek Uygulamalar

Gözden geçirme sürecini kolaylaştırmak için, lütfen anlama bağlı satır sonları kullanın (örn: bir satırda bir cümle). GitHub’da Markdown metinlerini doğru bir şekilde biçimlendirmek (örn: bağlantı, kalın, italik) için bu Markdown kopya kağıdına bakmanızı tavsiye ederiz. Ayrıca, .md dosyalarına isim verirken, lütfen parantezlerden kaçının, sadece küçük harfler kullanın ve boşluk yerine tire (-) kullanın.

Stil Kılavuzu

Katkı sürecini daha verimli hale getirmek için, biçimlendirme ve belge yazımını anlatan Stil Kılavuzumuzu okuyun.

Sözlük topluluğuna katılın!

Eğer düzenli olarak katkı yapmak istiyorsanız, aylık Sözlük Çalışma Grubu toplantılarımıza katılmayı değerlendirebilirsiniz. CNCF Takviminde, toplantı detaylarını bulabilirsiniz. Ayrıca, CNCF Slack’inde #glossary kanalından da geliştiriciler ve katkı verenler ile de iletişime geçebilirsiniz. Sizinle tanışmayı çok isteriz!

Mevcut bir issue üzerinde çalışma

Sözlük GitHub repository’sinden issue’lara bakın. Etiketleri (örn. Turkish language, help needed, good first issue) kullanarak filtreleme yapabilirsiniz.

Seçtiğiniz issue’nun başkasına atanmadığından emin olun. Örneğin, burada ilk 3 issue’nun müsait olduğunu ama 4.’nün başkasına atanmış olduğunu görebilirsiniz.

Bir issue seçtikten sonra, yorum yazın.

Bunlara ek olarak, CNCF Slack’indeki #glossary kanalında, proje geliştiricilerine haber verin. @Catherine Paganini, @Seokho Son, @Jihoon Seo ve @iamnoah kullanıcılarını da, görmelerinden emin olmak için mesajınızda etiketleyin.

Sonraki adımlar için, lütfen Yeni bir terim gönderme (PR oluşturma) kısmına bakın.

Note: Seçtiğiniz issue üzerinde proje geliştiricileri issue’yu size atadıktan sonra çalışabilirsiniz. Aynı anda sadece tek bir terim issue’yu talep edebilirsiniz. Birden çok terim üzerinde çalışacaksanız, bunları sırasıyla yapmanız gerekiyor.

Yeni terimler önerme

Başkalarının üzerinde çalışması için veya kendiniz tanımını oluşturmak için bir terim önerebilirsiniz. Her iki durumda da, bir issue oluşturarak işe başlamalısınız. Sözlük’e eklenmek için, her terimin CNCF’in cloud native tanımına uygun olması gerekmektedir Bu kuralın istisnası, sadece Cloud Native kavramlarını anlamak için kullanılan temel terimler olabilir.

Aşağıda, GitHub ile aşınalığı olmayanlar için bir adım adım kılavuz bulunmaktadır. GitHub hakkında tecrübeli olsanız bile, lütfen şu konular hakkında bilgi sahibi olmak için bu kılavuza gözatın:

1. Issue’lar ve yeni terimler için şablonların yerini belirleme.
2. İssue talep etme.
3. İmla kontrolü hatalarını çözme.

Yeni bir issue oluşturma

Sözlük GitHub repository’sindeki “Issues” kısmına gidin ve Yeni Issue (“New issue”) düğmesine basın.

Şablonlardan, “Request to add a new term (English)” seçeneğini seçin.

Önerdiğiniz terimi yazın, soruları cevaplayın, kutuları işaretleyin ve “Submit new issue” butonuna basın. Eğer sadece bir terim öneriyorsanız, işiniz bu kadar! Eğer terimin tanımının üzerinde çalışmak istiyorsanız, okumaya devam edin.

Oluşturduğunuz terimin tasnifi

Sonrasında, sözlük proje geliştiricileri, oluşturduğunuz issue’yu tasnif edecekler. Yani, terimin sözlüğün bir parçası olup olmayacağını değerlendirecekler. Her terim önerisi kabul edilmeyebilir. Sözlüğe eklenecek terimlerin, oturmuş ve yaygın olarak kullanılan Cloud Native kavramları olması gerekiyor.

Lütfen, proje geliştiricilerlerine Slack üzerinden yeni bir terim önerdiğinizi bildirin ve @Catherine Paganini, @Seokho Son, @Jihoon Seo, and/or @iamnoah kullanıcılarını mesajınızda etiketleyin. Eğer terimin tanımı üzerinde çalışmak istiyorsanız, issue’yu size atamaları için proje geliştiricilerlerine haber verin.

Yeni bir terim gönderme (PR oluşturma)

Stil Kılavuzunda açıklandığı gibi, bir Google Docs veya Word belgesi ile başlamanızı tavsiye ediyoruz.

Terim göndermeye hazır olduğunda, “content” klasörüne gidin.

…sonra “en” (İngilizce için) veya dilinizin ilk iki harfi.

… `_TEMPLATE.md dosyasını seçin.

İçeriği kopyalayın.

…ve “en” klasörüne geri gidin. “Add file” düğmesine basın ve “Create new file” seçeneğini seçin.

Adres kısmına, Örnek Uygulamalar kısmında bahsedildiği gibi isim yazın. Dosya isminin sonuna .md uzantısını ekleyin (bu uzantı olmadan dosyanızın önizlemesini göremezsiniz). Önceden kopyaladığınız içeriği şimdi aşağıya yapıştırın. Teriminizin tanımını artık yerine koyabilirsiniz. Oluşturduğunuz Markdown içeriğini kontrol etmek için, Örnek Uygulamalar kısmında bahsedildiği üzere, “Preview” düğmesine basın.

Aşağıya inin ve commit mesajı yazın. “Commit new file” düğmesine basın ve…

… artık bir PR göndermeye hazırsınız:

“Create pull request” düğmesine bastığınızda, gönderdiğiniz PR “Pull requests” sekmesinde görünecek.

Mevcut bir terimi değiştirme

Mevcut bir terimi değiştirmek için, bir issue oluşturarak istekte bulunabilir veya değişiklikleri kendiniz yaparak bir PR gönderebilirsiniz.

Issue oluşturarak değişiklik isteme

Eğer bir terimdeki bir sorunu haber vermek isterseniz, CNCF Sözlük sayfalarındaki “Sorun Bildir” seçeneğini kullanabilirsiniz. Sorun bildirmek istediğiniz sayfaya gidin ve “Sorun Bildir” linkine basın. Bu sizin için otomatik olarak bir issue oluşturma formu dolduracaktır.

Önerilerinizi ve sebeplerini tarif edin ve “Submit” düğmesine basın.

Bir terimi doğrudan değiştirme

Bir terimi değiştirip önerilerinizi bildirmek için, “Bu Sayfayı Düzenle” linkine basın.

Terimin GitHub sayfası açılacaktır. Değişikliklerinizi yapın ve bir PR oluşturun. Lütfen kurallarımıza uyduğunuzdan emin olmak için Örnek Uygulamalar kısmına bakın ve Stil Kılavuzu kısmını okuyun.

Sözlüğü yerelleştirmemize yardım edin

Sözlüğü yerelleştirmemize yardımcı olmak için, lütfen CNCF Slack’indeki #glossary-localizations kanalına katılın ve bize bir mesaj gönderin. Mevcut bir ekibe katılabilir veya yeni bir ekip kurabilirsiniz (gereklilikler için Localization Guide belgesini okuyun). Ekibin katkı sürecinin detaylarını öğrenmek için, lütfen katkı yapmak istediğiniz dildeki “Nasıl katkı yapabilirim?” kılavuzunu okuyun.

İmla kontrolü

İmla kontrolünün (spell check) hata vermesinin iki sebebi olabilir:

• Gönderdiğiniz PR imla hataları barındırıyor olabilir.
• Gönderdiğiniz PR kelime listesinde kayıtlı olmayan bazı kelimeler barındırıyor olabilir.

Kelime listesine yeni kelimeler eklemek için:

1. PR’ınızda, “wordlist.txt” dosyasını bulun.
2. “Edit this file” düğmesine basın ve eksik kelimeleri alfabetik sıraya uyacak şekilde ekleyin
3. Bir commit mesajı yazın ve “Sign off and propose changes” düğmesine basın.

Not: İmla kontrolü büyük-küçük harf duyarsız yapılmaktadır.

Bu kılavuz The Good Docs Project projesindeki şablonlar ile oluşturulmuştur.