Kısa cevap
GitHub linki eklemek yerine alıcının projenizi anlamasını kolaylaştırın: amaç, kişisel katkı, çalıştırma adımları ve sınırlar görünür olsun. Eğitim ve ekip projesini doğru tanımlayın. CV’de kısa bir görev maddesi, depoda açıklayıcı README kullanın; sır veya gerçek kullanıcı verisi paylaşmayın.
Bu rehberde
Örnekler kendi bilgilerinize uyarlamanız için hazırlanmıştır. Köşeli parantezleri değiştirin; yalnızca gerçek deneyim ve çalışmalarınızı yazın.
Projenin amacını teknik araçlardan önce açıklayın
Bir uygulama hangi ihtiyacı ele alıyor? Kullanıcı hangi akışı tamamlıyor? Projede hangi bölümü siz hazırladınız? Bu üç bilgi, uzun bir teknoloji listesinden önce okuyucuya bağlam verir. ‘React, Node, SQL’ demek tek başına ne geliştirdiğinizi açıklamaz.
Öğrenci veya kurs çalışmasını açıkça adlandırın. Eğitimde izlediğiniz iskeleti kendi üretiminiz gibi sunmak yerine hangi değişikliği yaptığınızı ayırın. Bir grup çalışmasının toplam sonucunu anlatabilirsiniz; kişisel görev bölümünde kendi katkınızı belirtin. Tamamlanmamış özellikleri çalışma sınırları başlığında yazın.
GitHub bağlantısıyla birlikte CV maddesi
Bu maddeler örnektir. Hazırlamadığınız test, mobil kontrol veya dokümantasyon cümlesini çıkarın. Teknik katkının kapsamını doğru yazmak, daha sonra aynı projeyi açıklarken tutarlı olmanızı sağlar. Elinizde gerçek ölçüm yoksa performans oranı eklemeyin.
Kısa proje anlatımı
[Proje adı] — [Eğitim / kişisel / ekip projesi] Amaç: [Gerçek problem veya kullanıcı akışı]. Katkım: [Hazırladığınız ekran / servis / analiz]. Araç: [Gerçekten kullandığınız araç]. Çıktı: [Çalışan uygulama / dokümantasyon / rapor]. GitHub: [Bağlantı]
Frontend örneği
Ders projesinde etkinlik listeleme ve filtreleme ekranlarını hazırladım. Form doğrulama ve mobil düzen bölümünü geliştirdim; kendi sorumluluğumu README’de belirttim.
Backend örneği
Kişisel projede kayıt ve listeleme servisinin veri modelini hazırladım. Girdi kontrolü ve hata yanıtlarını düzenledim; çalıştırma adımlarını dokümante ettim.
README için anlaşılır bir iskelet
README’deki adımları temiz bir ortamda veya farklı bir dizinde kontrol edin. Yapılandırma gerektiriyorsa hangi alanların gerekli olduğunu açıklayın; gerçek erişim anahtarını örneğe koymayın. Alıcının aynı ekrana ulaşması için bir demo veya örnek akış tarif edebilirsiniz.
Kaynak: GitHub Docs: README hakkında ↗
Proje açıklaması ve çalıştırma planı
# [Proje adı] ## Amaç [Ne yapıyor, kimin hangi ihtiyacını ele alıyor?] ## Çalışma türü ve katkım [Eğitim / kişisel / ekip projesi; kendi görevim] ## Gereksinimler [Gerçek araç ve sürümler] ## Çalıştırma [Doğru kurulum ve başlatma adımları] [Gerçek sır içermeyen örnek yapılandırma bilgisi] ## Temel akış [Uygulamanın incelenebilecek bölümü] ## Sınırlar [Tamamlanmamış özellikler, örnek veri, test kapsamı] ## Bağlantılar [Varsa çalışan demo veya dokümantasyon]
Göndermeden önce depo ve demo kontrolü
Ticari kodunuzu paylaşamıyorsanız gizli depoyu açmak zorunda değilsiniz. Paylaşılabilir görev ve çıktı açıklamasını kullanabilirsiniz. GitHub bağlantısı her aday veya alan için zorunlu değildir; ilgili ve incelemesi mümkün bir örnek sunmak amaçtır.
- Depo bağlantısı oturum kapalıyken açılıyor.
- README amacı, kişisel görevi ve çalıştırmayı açıklıyor.
- Demo varsa temel akış çalışıyor.
- CV’deki proje adı ve tarih doğru.
- Gerçek kullanıcı verisi ve erişim sırrı yok.
- Ekip ve eğitim katkısı doğru ayrılmış.
Sık sorulan sorular
GitHub için kaç proje eklemeliyim?
Zorunlu sayı yok. Kendi katkınızın ve amacın anlaşıldığı ilgili çalışmaları seçin.
Kurs projesi CV’ye yazılabilir mi?
Evet. Eğitim çalışması olduğunu ve sizin eklediğiniz gerçek katkıyı belirtin.
Paylaşamayacağım ticari kod varsa ne yapabilirim?
Kodu izinsiz açmayın. Görevinizi ve paylaşılabilir çıktınızı yazılı biçimde açıklayın.
Bir sonraki adım
CV’nizi hedef rolünüzle birlikte değerlendirin.
PDF CV’nizi analiz edin, somut önerilerle bir sonraki sürümünüzü hazırlayın.
CV’mi analiz edeyimÖnce demoyu deneyin →