Skip to main content

🤝 Development Guide

Projelerimizi geliştirirken izlediğimiz standart iş akışı (workflow) aşağıdadır. Amacımız, kod kalitesini korurken hızlı ilerleyebilmektir.

Gereklilikler​

Git Kurulumu​

Tüm süreç git üzerinden ilerlediğimiz için bilgisayarınızda (geliştirme ortamınızda) kurulu olması gereklidir. git

Ayrıca private repo üzerinde çalıştığımız için repo erişimi için git üzerinde bir kaç konfigürasyon yapılması gereklidir. Buradaki adımları takip ederek ilk repo'nuzu clone'layabilirsiniz.

1. Git Standartlarımız​

Branch İsimlendirme​

Branch isimleri şu formatta olmalıdır: tip/

  • feat/: Yeni özellikler
  • fix/: Bug çözümleri
  • refactor/: Kod iyileştirmeleri
  • docs/: Sadece dökümantasyon değişiklikleri

Commit Mesajları (Conventional Commits)​

Anlaşılır bir git geçmişi için Conventional Commits kullanıyoruz:

  • feat(ui): add primary button component
  • fix(api): resolve null pointer in user service

3. Pull Request (PR) Süreci​

  • Küçük PR'lar: PR'ların mümkün olduğunca küçük ve odaklanmış olmasına dikkat et. (İdeal: < 400 satır).
  • Açıklama: PR açıklamasında "Neyi değiştirdin?" ve "Nasıl test edebiliriz?" sorularına yanıt ver.
  • Review: En az 1 ekip arkadaşının onayını almadan main branch'e merge yapma.

4. Test ve Kalite​

  • Yazdığın kodun Unit/Integration testlerini eklemeyi veya güncellemeyi unutma.
  • Lokalinde lint ve test komutlarının hatasız çalıştığından emin ol.