GitHub’ta Bir Projeye Nasıl Commit Atılır? – Adım Adım Rehber 🚀

“Git commit atmak" yazılımcı dünyasının ekmek-su ikilisi gibi bir şeydir. Eğer kod yazıyorsan, değişikliklerini versiyon kontrol sistemine kaydetmeyi bilmek zorundasın. Bu rehberde sana, GitHub üzerinde bir projeye commit atma sürecini sıfırdan, adım adım ve bol örnekle anlatacağım. Önemli güncelleme: Ana repoya doğrudan değil, kendi branch’inde çalışıp her zaman Pull Request (PR) ile gönderiyoruz. Ayrıca projeyi lokalde görüp test etmek için virtualenv + duty ile nasıl ayağa kaldıracağını da anlatıyorum.

1️⃣ Bu Yazıya Başlamadan Önce Okuman Gerekenler#

Eğer daha önce Git ile SSH anahtarı eklemediysen veya GPG imzalı commit/etiket konusuna göz atmadıysan, önce şu iki makaleyi mutlaka oku:

• Git SSH-Key Oluşturma (Windows & Linux) 🔑
• Git ile GPG İmzalı Etiket Oluşturma ✍️

2️⃣ Ön Hazırlıklar#

Git Kurulumunu Kontrol Et#

Terminalini aç ve şu komutu çalıştır:

git --version

Örnek çıktı:

git version 2.50.1

Git yoksa git-scm.com/downloads üzerinden kurabilirsin.

GitHub Hesabına Giriş Yap#

GitHub hesabın yoksa github.com üzerinden hızlıca oluştur. Varsa tarayıcıdan giriş yap.

SSH Bağlantısını Test Et#

ssh -T git@github.com

Başarılıysa şöyle bir mesaj gelir:

Hi yuceltoluyag! You've successfully authenticated, but GitHub does not provide shell access.

GPG Anahtarını Kontrol Et#

git config --global user.signingkey

Anahtar görünmüyorsa GPG yazımı takip ederek ayarla.

3️⃣ Repoyu Klonlama#

Örnek repo: yuceltoluyag.github.io

git clone git@github.com:yuceltoluyag/yuceltoluyag.github.io.git
cd yuceltoluyag.github.io

4️⃣ Kendi Branch’inde Çalış: Neden ve Nasıl?#

Ana branch’e (genellikle main) doğrudan commit/push yapmıyoruz. Bunun yerine kendimize bir branch açıp orada çalışıyoruz. Böylece ana repo düzeni bozulmuyor, tüm katkılar Pull Request (PR) ile geliyor.

Yeni branch aç:

git checkout -b benim-branchim

Örnek:

git checkout -b arkadas-landing-duzenleme

5️⃣ Projeyi İlk Kez Lokalde Ayağa Kaldır (virtualenv + duty)#

Değişikliklerini görüp test edebilmek için projeyi lokalde çalıştırman çok önemli. Aşağıdaki adımlar ilk kurulum içindir:

# 1) Sanal ortam oluştur
python -m venv venv

# 2) Sanal ortamı aktif et
source venv/bin/activate     # Linux/Mac
# Windows PowerShell: .\venv\Scripts\Activate.ps1

# 3) Bağımlılıkları kur
pip install -r requirements.txt

# 4) Proje görevlerini/bağımlılıkları güncelle
duty update

# 5) Editörde aç (isteğe bağlı ama önerilir)
code .

# 6) Canlı yenileme ile lokal sunucuyu başlat
duty livereload

Terminal çıktısında lokal URL görürsün (çoğunlukla http://127.0.0.1:8000 veya http://localhost:8000). Tarayıcıda bu adrese giderek yaptığın değişiklikleri anlık görebilirsin. Sunucuyu durdurmak için terminalde ctrl c tuşlarına bas.

6️⃣ Değişiklik Yapma (Örnek)#

Örneğin README.md dosyasına ufak bir satır ekleyelim:

Bu satır, branch üzerinden yapılan commit örneğidir. 🚀

VS Code’da açmak için:

code .

Dosyayı düzenleyip kaydetmeyi unutma. Lokal sunucu açıksa (livereload), sayfa otomatik yenilenecektir.

7️⃣ Değişiklikleri Kontrol Et#

Neler değişmiş?

git status

Satır bazında farkı görmek için:

git diff

Yeşil yeni eklenenleri, kırmızı kaldırılanları gösterir.

8️⃣ Commit Hazırlama ve İmzalama (GPG -S)#

Değişikliklerini stage’e al:

git add .
# veya tek dosya için: git add README.md

İmzalı commit at:

git commit -S -m "README.md: örnek satır eklendi"

9️⃣ Branch’ini Remote’a Gönder (push)#

Artık branch’ini GitHub’a gönderebilirsin:

git push -u origin benim-branchim

Örnek:

git push -u origin arkadas-landing-duzenleme

-u parametresi, sonraki push/pull komutlarında branch izlemeyi kolaylaştırır.

🔟 Pull Request (PR) Aç: Her Zaman PR!#

Tarayıcıdan repo sayfasına git: https://github.com/yuceltoluyag/yuceltoluyag.github.io

GitHub genelde “Compare & pull request" butonunu gösterir. Tıkla ve PR’ını oluştur. Açıklama alanında:

• Ne yaptığını
• Neden yaptığını
• Nasıl test ettiğini

kısaca anlat. Bu repo için 2. ve sonraki çalışmalarda her zaman PR açıyoruz; böylece repo sahibiyle karışıklık olmaz, kod inceleme akışı korunur.

1️⃣1️⃣ GitHub Üzerinden Kontrol#

PR açıldıktan sonra commit’lerini ve değişikliklerini GitHub arayüzünde görebilirsin. GPG imzası doğruysa commit yanında Verified etiketi görünür.

1️⃣2️⃣ İkinci ve Sonraki Çalışma Oturumları (Tekrarlanan Akış)#

Projeyi tekrar açtığında şu adımları her zaman uygula:

cd yuceltoluyag.github.io

# 1) Sanal ortamı aktif et
source venv/bin/activate      # Windows: .\venv\Scripts\Activate.ps1

# 2) Proje görevlerini/bağımlılıkları güncelle
duty update

# 3) Editörde aç (opsiyonel)
code .

# 4) Lokal sunucuyu başlat (canlı yenileme)
duty livereload

Neden tekrar tekrar? Çünkü sanal ortam aktif edilmeden başlatılırsa uygulama açılmayacaktır. Ayrıca duty update, görevlerin/bağımlılıkların güncel kalmasını sağlar.

Yeni bir iş/özellik için önerilen akış:

# Ana branch'i güncelle:
git checkout main
git pull origin main

# Yeni branch oluştur:
git checkout -b task-kisa-adi

# Çalış, commit'le, push et:
git add .
git commit -S -m "feat: X özelliği eklendi"
git push -u origin task-kisa-adi

# Her zaman PR aç:
# GitHub -> Compare & pull request

1️⃣3️⃣ Sık Yapılan Hatalar ve Çözümleri#

1️⃣4️⃣ Örnek Tam Akış (Kısa Özet)#

# İlk kez:
git clone git@github.com:yuceltoluyag/yuceltoluyag.github.io.git
cd yuceltoluyag.github.io
git checkout -b arkadas-landing-duzenleme
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
duty update
code .
duty livereload   # Lokal URL'de değişiklikleri gör

# Çalış, düzenle, sonra:
git add .
git commit -S -m "docs: README'ye katkı akışı eklendi"
git push -u origin arkadas-landing-duzenleme
# GitHub'da: Compare & pull request → Açıklamayı yaz → PR gönder

Sonraki oturumlarda:

cd yuceltoluyag.github.io
source venv/bin/activate
duty update
code .
duty livereload
# Yeni iş için:
git checkout main && git pull origin main
git checkout -b yeni-gorev
# değiştir → commit → push → PR

🎯 Sonuç#

Artık “GitHub’ta bir projeye nasıl commit atılır?" sorusunun cevabını sadece öğrenmekle kalmadın; doğru akış olan branch üzerinde çalış + PR ile gönder sürecini, ayrıca projeyi lokalde ayağa kaldırma adımlarını da biliyorsun. Bu yaklaşım:

• Ana branch’i temiz ve stabil tutar,
• İnceleme (code review) sürecini mümkün kılar,
• Ekip içi karışıklıkları engeller,
• Değişikliklerini güvenle test edip doğrulamanı sağlar.

Kısacası, profesyonel bir katılım için ihtiyaç duyduğun tüm yapı taşları bu rehberde. Şimdi sıra sende: Kendi branch’ini aç, lokalde çalıştır, açıklayıcı commit mesajları yaz ve her zaman PR ile gönder. 🚀