turkce-kodlisted
Install: claude install-skill aiskillstore/marketplace
# Türkçe Kod Dokümantasyonu Rehberi
Bu skill, Türkçe yazılım projelerinde tutarlı, okunabilir ve profesyonel dokümantasyon yazmanı sağlar.
---
## 1. Yorum Satırı Standartları
### Genel Kurallar
- Yorumlar **Türkçe** yazılır, yabancı kelimeler italik veya tırnak içinde gösterilir.
- Yorum satırları büyük harfle başlar, nokta ile biter.
- Kod ne **yaptığını** değil, **neden** yaptığını açıklar.
### Python Örneği
```python
# Kullanıcı oturumunu doğrula ve yetki seviyesini belirle.
def oturum_dogrula(kullanici_id: int) -> dict:
"""
Verilen kullanıcı kimliğine göre oturum bilgilerini döndürür.
Args:
kullanici_id: Veritabanındaki benzersiz kullanıcı numarası.
Returns:
Kullanıcı bilgisi ve yetki seviyesini içeren sözlük.
Raises:
KullaniciBulunamadi: Kullanıcı veritabanında yoksa.
"""
...
```
### JavaScript / TypeScript Örneği
```typescript
/**
* Sepetteki ürünlerin toplam fiyatını hesaplar.
* KDV dahil tutar için `kdvDahilFiyat()` fonksiyonunu kullan.
*
* @param urunler - Fiyat bilgisi içeren ürün dizisi
* @returns Toplam fiyat (kuruş cinsinden, virgülsüz tam sayı)
*/
function toplamFiyatHesapla(urunler: Urun[]): number {
// Boş sepet kontrolü — backend doğrulamasına güvenmiyoruz.
if (urunler.length === 0) return 0;
return urunler.reduce((toplam, urun) => toplam + urun.fiyat, 0);
}
```
### Go Örneği
```go
// SiparisOlustur yeni bir sipariş kaydı oluşturur ve veritabanına ekler.
// Stok kontrolü bu fonksi