Genel Sohbet

Açık kaynak projeye ilk katkı: issue seçmekten pull request'e

kaan.yildiz Mid 1 saat önce · 0 görüntülenme

Açık kaynağa katkı vermek hem öğrenmenin hem de portföy oluşturmanın en iyi yollarından biri. İlk adım genellikle en zorudur, çünkü nereden başlayacağını bilmezsin. İşte adım adım bir yol.

1. Proje seç

En iyi başlangıç, zaten kullandığın bir araç ya da kütüphanedir. Nasıl çalıştığını bilirsin ve eksiklerini fark etmişsindir. Bakılacak işaretler:

Son birkaç ay içinde commit ve birleştirilmiş pull request var mı?
Issue'lara cevap veriliyor mu?
CONTRIBUTING.md dosyası var mı?

2. Uygun bir iş bul

GitHub'da good first issue veya help wanted etiketlerine bak. Kod yazmak zorunda değilsin, şunlar da değerli katkılardır:

Dokümantasyondaki hataları ve eksik örnekleri düzeltmek
Türkçe çeviri (projede çeviri desteği varsa)
Bir hatayı tekrar üretip adımlarını issue'ya yazmak
Test eklemek

Bir issue üzerinde çalışmaya başlamadan önce yorum yazıp sor: "I'd like to work on this, is it still available?" Başkası da üzerinde çalışıyor olabilir ya da proje sahibinin farklı bir çözüm beklentisi olabilir.

3. Fork, klonla, dal aç

# GitHub'da Fork düğmesine bastıktan sonra:
git clone https://github.com/KULLANICI_ADIN/proje.git
cd proje
git remote add upstream https://github.com/ASIL_SAHIP/proje.git
git checkout -b duzeltme/readme-ornek

Ana dal (main) üzerinde çalışma. Her iş için ayrı dal açarsan aynı anda birden fazla pull request gönderebilirsin.

4. Projenin kurallarına uy

CONTRIBUTING.md dosyasını oku: kod biçimi, test komutu, commit mesajı biçimi orada yazar.
Testleri yerelde çalıştır.
Değişikliği küçük tut. Bir pull request tek bir sorunu çözsün. "Bu arada şuraları da düzelttim" diye ilgisiz değişiklik eklemek incelemeyi zorlaştırır.

5. Pull request aç

Açıklamada şunlar olsun:

Neyi değiştirdin ve neden?
İlgili issue numarası (Fixes #123 yazarsan PR birleşince issue otomatik kapanır)
Nasıl test ettin?
Arayüz değişikliğiyse ekran görüntüsü

6. İncelemeye sabırla cevap ver

Proje sahipleri genellikle gönüllüdür, cevap birkaç gün ya da hafta sürebilir. Değişiklik istenirse aynı dala yeni commit gönder, PR kendiliğinden güncellenir. Eleştiriler kodla ilgilidir, seninle değil. Bir hafta ses çıkmazsa kibarca bir hatırlatma yazmak normaldir.

Ana projede değişiklikler olduysa dalını güncel tut:

git fetch upstream
git rebase upstream/main
git push --force-with-lease

Sizden

İlk açık kaynak katkınız neydi? Türk geliştiricilerin başlattığı ve katkı bekleyen projeleri biliyorsanız bu konuya yazın, yeni başlayanlar için güzel bir liste oluşsun.

#açık-kaynak #git #github #pull-request