turkce-kod

# 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...