Files
everything-claude-code/docs/tr/rules/common/coding-style.md
Berkcan Gümüşışık fd2a8edb53 Add Turkish (tr) docs and update README (#744)
* Add Turkish (tr) docs and update README

Add a full set of Turkish documentation under docs/tr (agents, changelog, CLAUDE guide, contributing, code of conduct, and many agents/commands/skills/rules files). Update README to include a link to the Turkish docs and increment the supported language count from 5 to 6. This commit adds localized guidance and references to help Turkish-speaking contributors and users.

* Update docs/tr/TROUBLESHOOTING.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* Update docs/tr/README.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* docs(tr): fix license link and update readmes

Update Turkish docs: change license badge link to point to repository root (../../LICENSE), increment displayed language count from 5 to 6, and remove two outdated related links from docs/tr/examples/README.md to keep references accurate.

* Update docs/tr/commands/instinct-import.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

* Update docs/tr/commands/checkpoint.md

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

---------

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
2026-03-22 15:37:04 -07:00

1.6 KiB
Raw Blame History

Kodlama Stili

Immutability (KRİTİK)

DAIMA yeni nesneler oluştur, mevcut olanları ASLA değiştirme:

// Pseudocode
YANLIŞ:  modify(original, field, value) → original'i yerinde değiştirir
DOĞRU: update(original, field, value) → değişiklikle birlikte yeni kopya döner

Gerekçe: Immutable veri gizli yan etkileri önler, debug'ı kolaylaştırır ve güvenli eşzamanlılık sağlar.

Dosya Organizasyonu

ÇOK KÜÇÜK DOSYA > AZ BÜYÜK DOSYA:

  • Yüksek kohezyon, düşük coupling
  • Tipik 200-400 satır, maksimum 800
  • Büyük modüllerden utility'leri çıkar
  • Type'a göre değil, feature/domain'e göre organize et

Hata Yönetimi

Hataları DAIMA kapsamlı bir şekilde yönet:

  • Her seviyede hatalarııkça ele al
  • UI'ye yönelik kodda kullanıcı dostu hata mesajları ver
  • Server tarafında detaylı hata bağlamı logla
  • Hataları asla sessizce yutma

Input Validasyonu

Sistem sınırlarında DAIMA validate et:

  • İşlemeden önce tüm kullanıcı girdilerini validate et
  • Mümkün olan yerlerde schema tabanlı validasyon kullan
  • ık hata mesajlarıyla hızlıca başarısız ol
  • Harici verilere asla güvenme (API yanıtları, kullanıcı girdisi, dosya içeriği)

Kod Kalitesi Kontrol Listesi

İşi tamamlandı olarak işaretlemeden önce:

  • Kod okunabilir ve iyi adlandırılmış
  • Fonksiyonlar küçük (<50 satır)
  • Dosyalar odaklı (<800 satır)
  • Derin iç içe geçme yok (>4 seviye)
  • Düzgün hata yönetimi
  • Hardcoded değer yok (sabit veya config kullan)
  • Mutasyon yok (immutable pattern'ler kullanıldı)