Açık Kaynağa İlk Katkınızı Nasıl Yaparsınız?
GitHub'da fork, branch, commit ve PR sürecini adım adım anlatan başlangıç rehberi.
LibreTurk
Açık kaynak projelere katkıda bulunmak, ilk bakışta korkutucu görünebilir. Devasa kod tabanları, karmaşık CI/CD süreçleri ve deneyimli geliştiricilerin incelemeleri… Ama gerçek şu ki: herkes bir yerden başladı ve ilk adım sandığınızdan çok daha kolay.
Başlamadan Önce
Tek ihtiyacınız olan şeyler:
- Bir GitHub hesabı
- Git’in bilgisayarınızda kurulu olması
- Merak ve biraz sabır
Adım 1: Projeyi Fork’layın
Katkıda bulunmak istediğiniz projenin GitHub sayfasına gidin ve sağ üst köşedeki Fork butonuna tıklayın. Bu, projenin bir kopyasını kendi hesabınıza oluşturur.
# Fork'ladığınız projeyi klonlayın
git clone https://github.com/KULLANICI-ADINIZ/proje-adi.git
cd proje-adi
Adım 2: Branch Oluşturun
Ana branch üzerinde çalışmak yerine, her değişiklik için yeni bir branch oluşturun:
git checkout -b duzeltme/yazim-hatasi
Branch isimlerinde açıklayıcı olun. fix/typo-in-readme gibi isimler, inceleme yapan kişiye ne beklediğini anlatır.
Adım 3: Değişikliğinizi Yapın
Küçük başlayın. İlk katkınız için şunlar ideal:
- README’deki bir yazım hatasını düzeltmek
- Dokümantasyona bir örnek eklemek
- Eksik bir çeviriyi tamamlamak
- Bir test eklemek
Adım 4: Commit ve Push
git add .
git commit -m "docs: README'deki yazım hatası düzeltildi"
git push origin duzeltme/yazim-hatasi
Commit mesajlarında Conventional Commits formatını kullanmaya çalışın.
Adım 5: Pull Request Açın
GitHub’da fork’unuza gidin ve “Compare & pull request” butonuna tıklayın. PR açıklamasında:
- Ne değiştirdiğinizi kısaca açıklayın
- Neden bu değişikliğin gerekli olduğunu belirtin
- İlgili bir issue varsa referans verin (
Fixes #42gibi)
İlk PR’ınız Reddedilirse?
Panik yapmayın. Geri bildirim almak, öğrenme sürecinin en değerli parçasıdır. İnceleme yapan kişinin önerilerini dikkate alın, gerekli değişiklikleri yapın ve tekrar push’layın.
Unutmayın: açık kaynak topluluğu, mükemmellik değil katılım bekler. İlk adımınızı atın — gerisini birlikte çözeriz.