Mentorluk ve Teknik Belgeleme
Eşli programlama ve zamanında geri bildirimle yeni ekip arkadaşlarınızı geliştirmeyi, mimari kararlar için ADR'ler yazmayı ve başkalarının güvendiği güncel belgeleri korumayı öğrenin.
Mentorluk ve Teknik Belgeleme, CoddyKit'te ücretsiz bir Frontend Academy dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Frontend Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Frontend Academy kursu toplamda 4 dersten oluşur.
Kıdemli Olmak Başkalarını Güçlendirmektir
Kıdemli düzeyde işiniz en çok kodu yazmak değil, ekibinizi daha iyi hâle getirmektir. Yeni başlayanlara mentorluk yapın, bilginizi ölçeklendiren belgeler yazın, öğreten kod incelemeleri yapın ve başkalarının güvenli biçimde hızlı ilerleyebilmesi için mimariyi şekillendirin.
Eşli Programlamayla Mentorluk
Eşli programlama, yeni başlayan bir geliştiriciyi yetiştirmenin en hızlı yoludur. Birlikte oturun (veya ekranınızı paylaşın); siz yönlendirirken bırakın, kodu o kullansın. Kontrolü ele alma isteğinize direnin; düşüncelerinizi açıklayın ve Sokratik sorular sorun.
Uygun Zorlukta Görevler
Yeni başlayanlara mevcut becerilerinin biraz üzerindeki görevleri verin. Çok kolay görev = gelişim yok. Çok zor görev = bocalama ve hayal kırıklığı. Seviyeyi ayarlayın: 'Bence bunu biraz yardımla yapabilirsiniz; takılırsanız birlikte çalışmaktan memnuniyet duyarım.'
Öğretme Olarak Kod İncelemesi
Yeni başlayanların PR'larında, önemsiz olmayan her yorumun arkasındaki nedeni açıklayın. İlgili belgelere, önceki PR'lara veya makalelere bağlantı verin. Kötü inceleme: 'useCallback kullanın'. İyi inceleme: 'Bu işlev her oluşturma işleminde yeniden oluşturuluyor; onu anımsanmış bir alt bileşene aktarmak gereksiz yeniden oluşturmaya neden oluyor. useCallback bu işlevi anımsar. Bunu yaptığımız bir örnek PR burada: #1234'.
Mimari Karar Kayıtları (ADR'ler)
Bir ADR, önemli bir mimari tercihi belgeler: neye karar verdiğimizi, nedenini, değerlendirilen seçenekleri ve kabul edilen ödünleşimleri. Gelecekteki hâliniz, bugünkü hâlinize teşekkür edecek.
# ADR-0007: Use TanStack Query for server state
Date: 2026-05-01
Status: Accepted
## Context
We currently scatter useEffect+fetch+useState patterns across the app.
Cache invalidation is inconsistent, race conditions cause stale data.
## Decision
Adopt TanStack Query (@tanstack/react-query v5) for all server state.
## Consequences
+ Built-in caching, deduplication, optimistic updates.
+ Standard pattern across team.
- Adds ~13KB gzipped.
- Team needs to learn query keys conventions.
## Alternatives Considered
- SWR: smaller, but fewer features (no mutations).
- Apollo Client: overkill (we don't use GraphQL).
- Custom hook: doesn't solve cache invalidation.
## References
- React Query docs: ...ADR'ler Nerede Bulunur
ADR'leri depoda, docs/adr/ konumunda, ardışık numaralarla saklayın. ADR'ler, açıkladıkları kodun yanında bulunur. Araçlar: taranabilir web arayüzü için adr-tools ve log4brains.
README Kalitesi
Her paketin, kitaplığın ve önemli özelliğin bir README'si olmalıdır. Şunları ekleyin: ne yaptığı, nasıl yükleneceği, nasıl kullanılacağı (kod örnekleriyle), nasıl katkıda bulunulacağı, sınamaların nasıl çalıştırılacağı ve hata ayıklamanın nasıl yapılacağı. README güdümlü geliştirme: önce README'yi yazın, ardından bu belirtime göre geliştirin.
Satır İçi Kod Yorumları — Ne Zaman Kullanılmalı
Yorumlar ne olduğunu değil, nedenini açıklamalıdır. Kod ne olduğunu gösterir. Yorumlar şunları açıklar: iş kuralları, açıkça anlaşılmayan ödünleşimler, biletlere veya hatalara bağlantılar ve beklenmedik durumlarla ilgili uyarılar.
// BAD: comment restates the code
// Increment counter by 1
counter++;
// GOOD: comment explains business context
// Stripe webhook can arrive twice — increment only if signature is fresh.
// See: https://stripe.com/docs/webhooks/best-practices#idempotency
if (!seen.has(event.id)) counter++;Operasyonel Görevler İçin Çalıştırma Kılavuzları
Tekrarlanan veya riskli operasyonel görevlerin nasıl yapılacağını belgeleyin: 'Stripe API anahtarı nasıl yenilenir', 'Başarısız bir dağıtımdan nasıl kurtulunur', 'Yavaş bir API yanıtında nasıl hata ayıklanır'. Yeni ekip üyeleri size haber vermek zorunda kalmadan bu adımları izleyebilir.
Güncel Tutulan Belgeler
Güncelliğini yitirmiş belgeler, hiç belge olmamasından daha kötüdür. Belgeleri tarihlendirin. Üç ayda bir gözden geçirin. Kimsenin güncellemediği belgeleri silin. Daha iyisi: Belgeleri koddan oluşturun (bileşenler için Storybook, API'ler için TypeDoc, uç noktalar için OpenAPI).
Teknik Konuşmalar ve Bilgi Paylaşım Toplantıları
Öğrendikleriniz hakkında ekibinize 20-30 dakikalık konuşmalar yapın: yeni bir kitaplık, bir hata ayıklama öyküsü veya yararlı bulduğunuz bir kalıp. Bu, düşüncelerinizi düzenlemeye zorlar ve başkalarına öğretir.
Psikolojik Güvenlik Oluşturmak
Soru sormaktan korkan yeni başlayanlar gelişemez. 'Bilmiyorum' demeyi normalleştirin. Hata yapmayı güvenli hâle getirin; suçlamak yerine olay sonrası değerlendirmeyi kutlayın. Kıdemli olarak tepkileriniz ekibin havasını belirler.
Kahramanca Kodlama Tuzağı
Her üretim olayını tek başınıza çözen kişi olmayın. Düzeltmeyi belgeleyin, bir dahaki sefere bir ekip arkadaşınızla birlikte çalışın ve tanılamayı otomatikleştirin. Kahramanlıklarınıza ihtiyaç duyan bir ekip kırılgandır.
Hızlı Kontrol
Bir Mimari Karar Kaydının (ADR) temel amacı nedir?
Özet: Mentorluk ve Belgeler
Kıdemli olmak, en çok kodu yazmak değil, başkalarını güçlendirmektir. Eşli programlama yapın; kod incelemesiyle öğretin; uygun zorlukta görevler verin. docs/adr/ konumundaki ADR'ler kararların neden alındığını kaydeder. Her paket için README yazın. Yorumlar neyi değil, nedeni açıklar. Operasyon görevleri için çalıştırma kılavuzları kullanın. Güncel tutulan belgeler (Storybook, TypeDoc, OpenAPI) durağan markdown belgelerinden daha iyidir. Psikolojik güvenlik oluşturun. Kahramanca kodlamadan kaçının.
Sıkça Sorulan Sorular
“Mentorluk ve Teknik Belgeleme” dersi ücretsiz mi?
Evet — “Mentorluk ve Teknik Belgeleme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Frontend Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Frontend Academy kursu toplamda 4 dersten oluşur.
“Mentorluk ve Teknik Belgeleme” dersinde ne öğreneceğim?
Eşli programlama ve zamanında geri bildirimle yeni ekip arkadaşlarınızı geliştirmeyi, mimari kararlar için ADR'ler yazmayı ve başkalarının güvendiği güncel belgeleri korumayı öğrenin. Frontend Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
Frontend Academy öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te Frontend Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.
“Mentorluk ve Teknik Belgeleme” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu Frontend Academy dersinde kod yazıp çalıştırabilir miyim?
Evet. Her Frontend Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- Ön Uç Sistem Tasarımı Mülakatları
- Kod İnceleme Kültürü ve PR En İyi Uygulamaları
- Mentorluk ve Teknik Belgeleme
- Güncel Kalma: Spesifikasyonları ve Önerileri Okuma