Yazılımcılar İçin GitHub Portföyü | Başarılı Kariyer Rehberi

Yazılım dünyasında GitHub portföyü, dijital kartvizitinizdir. İşverenler ve recruiter'lar, CV'nizden çok GitHub profilinize bakar. Peki, etkileyici bir GitHub portföyü nasıl oluşturulur? Projelerinizi nasıl sergilemeli, README dosyalarını nasıl yazmalı ve profilinizi nasıl optimize etmelisiniz? İşte yazılımcılar için GitHub portföy rehberi:

GitHub Portföyü Nedir ve Neden Önemlidir?

GitHub portföyü, yazılım projelerinizi, kod kalitенizi ve teknik becerilerinizi sergilediğiniz bir platformdur. Şirketler artık sadece CV'ye bakmıyor; gerçek kod örnekleri görmek istiyor. İyi düzenlenmiş bir GitHub profili:

• İş görüşmelerinde güçlü bir referans sağlar
• Kod yazma yeteneğinizi kanıtlar
• Problem çözme becerilerinizi gösterir
• Açık kaynak topluluğuna katkılarınızı sergiler
• Junior, mid-level ve senior pozisyonlarda fark yaratır
• Freelance ve uzaktan çalışma fırsatları bulmanızı kolaylaştırır

1. Profesyonel GitHub Profili Oluşturma

Profil Fotoğrafı ve Bio

GitHub profil fotoğrafınız, profesyonel ve net olmalıdır. Bio kısmında kim olduğunuzu kısaca tanıtın, hangi teknolojilerle çalıştığınızı belirtin, ilgi alanlarınızı ekleyin.

Örnek bio: "Full-Stack Developer | React, Node.js, Python | AI & Machine Learning Enthusiast | Open Source Contributor"

README.md ile Profil Sayfası Oluşturma

GitHub'da kendi kullanıcı adınızla aynı isimde bir repository oluşturarak özel bir profil sayfası yapabilirsiniz. Bu sayfa, profilinizi ziyaret eden herkese ilk gösterilen içerik olur.

Profil README'nizde olması gerekenler:

• Kısa bir tanıtım
• Kullandığınız teknolojiler (badge'lerle gösterilebilir)
• İstatistikleriniz (GitHub Stats)
• En iyi projeleriniz
• İletişim bilgileri
• Blog veya sosyal medya linkleri

2. Kaliteli Repository Oluşturma

Repository İsimlendirme

Repository isimleri açıklayıcı, kısa ve anlamlı olmalıdır. Kebab-case kullanın.

❌ Kötü örnekler: "project1", "myapp", "test"

✅ İyi örnekler: "weather-forecast-app", "ecommerce-backend-api", "task-management-dashboard"

Repository Açıklaması (Description)

Her repository'nin kısa ama net bir açıklaması olmalı. Bu açıklama, arama sonuçlarında görünür ve projenizin ne yaptığını anlatır.

Örnek: "Real-time weather forecast application built with React and OpenWeather API. Features include geolocation, 7-day forecast, and responsive design."

3. README Dosyası Yazma: Projenizin Vitrini

README.md dosyası, repository'nizin en önemli parçasıdır. İyi yazılmış bir README, projenizin profesyonelliğini gösterir.

İdeal README Yapısı:

• Proje başlığı ve açıklama
• Proje görseli/GIF
• İçindekiler
• Özellikler
• Kullanılan teknolojiler
• Kurulum talimatları
• Kullanım örnekleri
• Ekran görüntüleri
• Canlı demo linki
• Katkıda bulunma
• Lisans
• İletişim

4. Portföy Projeleri Seçimi: Neyi Paylaşmalısınız?

Kalite > Miktar

50 yarım kalmış proje yerine, 5-10 tane bitmiş, kaliteli proje çok daha değerlidir.

İdeal Portföy Projeleri:

1. Full-Stack Uygulama: Frontend + Backend + Database, Authentication sistemi, CRUD işlemleri, Responsive tasarım, Deploy edilmiş

2. API Projesi: RESTful veya GraphQL API, Dokümantasyon (Swagger/Postman), Error handling, Authentication & Authorization

3. Özel/Karmaşık Algoritma Projesi: Veri yapıları uygulaması, Machine Learning modeli, Data visualization

4. Açık Kaynak Katkıları: Popüler projelere yaptığınız PR'lar, kendi açık kaynak projeniz

5. Kod Kalitesi ve Best Practices

Temiz Kod Yazma

Kodlarınız okunabilir olmalı, değişken isimlendirmelerine dikkat edin, yorum satırları ekleyin.

Commit Mesajları

Commit mesajlarınız anlamlı ve açıklayıcı olmalı.

❌ Kötü commit mesajları: "update", "fix", "asdasd"

✅ İyi commit mesajları: "feat: Add user authentication with JWT", "fix: Resolve memory leak in dashboard component"

6. Dokümantasyon ve Yorumlar

Kod Yorumları

Karmaşık mantık blokları için yorum ekleyin, ancak aşırıya kaçmayın. Kod kendini anlatmalı.

API Dokümantasyonu

Backend projelerinizde Swagger veya Postman collection'ı ekleyin.

7. GitHub Profil Optimizasyonu (SEO)

Pinned Repositories

En iyi 6 projenizi sabitleyin (pin). Bunlar profil sayfanızda ilk gösterilen projeler olur.

GitHub Activity

Düzenli commit yapmak, aktif bir developer olduğunuzu gösterir. Her gün veya haftada en az 3-4 gün commit yapın.

8. Canlı Demo ve Deployment

Her projenizi mutlaka deploy edin. "Localhost'ta çalışıyor" yeterli değil.

Ücretsiz Deployment Platformları:

Frontend: Vercel, Netlify, GitHub Pages

Backend: Render, Railway, Fly.io

Full-Stack: Vercel + MongoDB Atlas, Netlify + Supabase

9. GitHub Actions ve CI/CD

Otomatik testler ve deployment işlemleri, profesyonelliğinizi gösterir.

10. Lisans Ekleme

Her projeye lisans ekleyin. Bu, projenizin profesyonel olduğunu gösterir.

Popüler lisanslar: MIT License, Apache 2.0, GPL

11. Contribution Graph'ı Yeşil Tutma

Contribution graph'ınız, aktivitenizin görsel göstergesidir. Düzenli commit yapın, açık kaynak projelere PR gönderin.

12. Profil Badges (Rozet) Kullanımı

README dosyalarınıza rozet ekleyerek teknolojilerinizi görsel olarak gösterebilirsiniz.

13. GitHub'da Kaçınılması Gerekenler

• ❌ Şifre, API key gibi hassas bilgileri push etmek
• ❌ node_modules gibi büyük klasörleri yüklemek
• ❌ Yarım kalmış projeleri paylaşmak
• ❌ README olmayan repository'ler
• ❌ Anlaşılmaz commit mesajları
• ❌ Copy-paste tutorial kodları

14. Portföy Kontrol Listesi

Projenizi yayınlamadan önce:

• ✅ README.md dosyası eksiksiz mi?
• ✅ Proje açıklaması ve topic'ler eklendi mi?
• ✅ .gitignore doğru yapılandırılmış mı?
• ✅ Hassas bilgiler temizlendi mi?
• ✅ Kod düzgün formatlanmış mı?
• ✅ Canlı demo linki var mı?
• ✅ Lisans dosyası var mı?

Sonuç

GitHub portföyü, yazılım kariyerinizin temel taşlarından biridir. İyi düzenlenmiş, kaliteli projelerle dolu bir GitHub profili, CV'nizden daha değerli olabilir. Unutmayın: İşverenler kodunuzu görmek istiyor!

Başarılı bir GitHub portföyü için: Kaliteli, bitmiş projeler paylaşın, README dosyalarına özen gösterin, düzenli commit yapın, açık kaynak topluluğuna katkıda bulunun, projelerinizi deploy edin, temiz, okunabilir kod yazın.

Anahtar Kelimeler: github portföyü, yazılımcı portföyü, github profil optimizasyonu, readme nasıl yazılır, github projeleri, developer portfolio, açık kaynak katkı, github best practices, yazılım mühendisi portfolio