🐣 Ekibe Hoş Geldin!
Seninle birlikte çalışacağımız için çok heyecanlıyız. Bu rehber, ekibimize ve projelerimize en hızlı şekilde adapte olabilmen için hazırlandı. İlk birkaç gününde bu listeyi takip ederek kurulumlarını tamamlayabilirsin.
Bu döküman bir checklist mantığıyla hazırlanmıştır. Takıldığın her yerde çekinmeden takım arkadaşlarına yazabilirsin!
Hesaplar ve Erişimler 🔑
İlk gününde aşağıdaki platformlara erişimin olduğundan emin ol:
- GitHub: Organizasyonumuza davet edildin mi?
- Internal Docs: Döküman sayfamıza ulaşabiliyor musun ?
Github Organizasyonu
Tüm organizasyonel işlerimizi github teamhalaskar organizasyonumuz üzerinden yapıyoruz. Öncelikle eğer bir Github hesabın yoksa hemen Github/signup üzerinden kaydol ve kullanıcı adını veya kayıt olduğun mail adresini ekip liderine ilet. Organizasyon daveti gelmediyse mail adresini kontrol et ve ekip liderine danışın.
Internal Docs
Tüm çalışmalarımızın, standartlarımızın tek bir yerden ulaşabileceğin bir döküman portalıdır [https://docs.teamhalaskar.com]. Öncelikle buraya website olarak erişmek isterseniz Cloudflare hesabınızın olması gerekmektedir. Normalde dışarıdan girmek isteyen ve sizin ilk başta göreceğiniz sayfa bu şekilde olacaktır:
Döküman website'sine erişimi için Cloudflare Zero Trust kullanarak authentication işlemlerini yönetiyoruz. Bu yüzden Cloudflare'a kayıt olduktan sonra [https://docs.teamhalaskar.com] adresine girip kayıt olduğunuz mail adresiniz ile giriş yapabilirsiniz.
E-mail adresinizi girip "Send me a code" tıkladıktan sonra bazen Cloudflare'den dolayı mail'in gelmesinde sorun olabiliyor. 5–10 dakika içinde mail ulaşmazsa, Cloudflare’a kayıt olurken kullandığınız mail adresiyle giriş yaptığınızdan emin olup işlemi tekrar deneyiniz.
Lokal Geliştirme Ortamı 💻
Projelerimizi bilgisayarında ayağa kaldırmak için şu adımları izle. Detaylı teknik tarifler için Kurulum Rehberi sayfasına bakabilirsin.
- Git Kurulumu: İlk başta windows'ta çalışıyorsan git indir (ubuntu/debian kullanıyorsan kurulu genelde gelir). Kurulum adımlarını da buradan takip edin.
- Docker: Bazı projelerimizde docker container kullanıyoruz (örn: gcs) çalışması için Docker Desktop veya OrbStack kur. Ekstra olarak image'lerimize ulaşmak için de buradaki adımları takip edin.
- IDE: Tercihen VS Code öneriyoruz. İsteğe bağlı olarak Cursor veya Antigravity kullanabilirsin.
Standartlar 📚
Geliştirme sürecinde nasıl ilerlediğimizi anlamak çok önemli. Lütfen aşağıdaki belirtilen sayfaları dikkatlice oku:
- Development: Branch isimlendirme ve PR (Pull Request) sürecimiz nasıl işliyor?
- Style Guide: Döküman kurallarımız.
- ADR (Karar Kayıtları): Geçmişte neden bazı kararlar aldık?
🚀 İlk Görev (Guild Registry)
Hazır olduğunda, guild-registry repo'suna ilk PR'ini yapabilirsin. Aşağıdaki adımları takip et:
- Repo'yu Klonla:
git clone https://github.com/teamhalaskar/guild-registry.git - Branch Oluştur:
git checkout -b feat/add-<name>not:<name>yerine kendi ismini yaz. - Değişiklikleri Yap: Gerekli düzenlemeleri yap. Daha fazla detay için repo bakınız.
- Commit ve Push:
git add . && git commit -m "feat: add my first contribution" && git push origin feat/add-<name> - PR Aç: GitHub'da yeni bir Pull Request oluştur.
- Merge: Eğer validation'da bir sıkıntı yok ise merge yap!
İlk Pull Request'ini gönderdiğinde ekipteki herkes sana yardımcı olacak. Hata yapmaktan korkma, burası bir öğrenme alanı!
Tekrar hoş geldin, başarılar dileriz! 🚀