Blog'a dön

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 #42 gibi)

İ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.

başlangıç github rehber
Tüm yazılar
Blog'a dön

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 #42 gibi)

İ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.

başlangıç github rehber
Tüm yazılar