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>
This commit is contained in:
Berkcan Gümüşışık
2026-03-23 01:37:04 +03:00
committed by GitHub
parent bb1efad7c7
commit fd2a8edb53
139 changed files with 26670 additions and 2 deletions

View File

@@ -0,0 +1,80 @@
# Refactor Clean
Her adımda test doğrulaması ile ölü kodu güvenle tanımla ve kaldır.
## Adım 1: Ölü Kodu Tespit Et
Proje türüne göre analiz araçlarını çalıştır:
| Araç | Ne Bulur | Komut |
|------|--------------|---------|
| knip | Kullanılmayan export'lar, dosyalar, bağımlılıklar | `npx knip` |
| depcheck | Kullanılmayan npm bağımlılıkları | `npx depcheck` |
| ts-prune | Kullanılmayan TypeScript export'ları | `npx ts-prune` |
| vulture | Kullanılmayan Python kodu | `vulture src/` |
| deadcode | Kullanılmayan Go kodu | `deadcode ./...` |
| cargo-udeps | Kullanılmayan Rust bağımlılıkları | `cargo +nightly udeps` |
Hiçbir araç yoksa, sıfır import'lu export'ları bulmak için Grep kullanın:
```
# Export'ları bul, sonra herhangi bir yerde import edilip edilmediklerini kontrol et
```
## Adım 2: Bulguları Kategorize Et
Bulguları güvenlik katmanlarına göre sırala:
| Katman | Örnekler | Aksiyon |
|------|----------|--------|
| **GÜVENLİ** | Kullanılmayan yardımcılar, test yardımcıları, dahili fonksiyonlar | Güvenle sil |
| **DİKKAT** | Component'ler, API route'ları, middleware | Dinamik import'ları veya harici tüketicileri olmadığını doğrula |
| **TEHLİKE** | Config dosyaları, giriş noktaları, tip tanımları | Dokunmadan önce araştır |
## Adım 3: Güvenli Silme Döngüsü
Her GÜVENLİ öğe için:
1. **Tam test paketini çalıştır** — Baseline oluştur (tümü yeşil)
2. **Ölü kodu sil** — Cerrahi kaldırma için Edit aracını kullan
3. **Test paketini yeniden çalıştır** — Hiçbir şeyin bozulmadığını doğrula
4. **Testler başarısız olursa** — Hemen `git checkout -- <file>` ile geri al ve bu öğeyi atla
5. **Testler geçerse** — Sonraki öğeye geç
## Adım 4: DİKKAT Öğelerini İdare Et
DİKKAT öğelerini silmeden önce:
- Dinamik import'ları ara: `import()`, `require()`, `__import__`
- String referansları ara: route isimleri, config'lerdeki component isimleri
- Public paket API'sinden export edilip edilmediğini kontrol et
- Harici tüketici olmadığını doğrula (yayınlanmışsa bağımlıları kontrol et)
## Adım 5: Duplikatları Birleştir
Ölü kodu kaldırdıktan sonra şunları ara:
- Neredeyse aynı fonksiyonlar (%80'den fazla benzer) — birinde birleştir
- Gereksiz tip tanımları — birleştir
- Değer eklemeyen wrapper fonksiyonlar — inline yap
- Amacı olmayan re-export'lar — yönlendirmeyi kaldır
## Adım 6: Özet
Sonuçları raporla:
```
Ölü Kod Temizliği
──────────────────────────────
Silindi: 12 kullanılmayan fonksiyon
3 kullanılmayan dosya
5 kullanılmayan bağımlılık
Atlandı: 2 öğe (testler başarısız)
Kazanç: ~450 satır kaldırıldı
──────────────────────────────
Tüm testler geçiyor ✅
```
## Kurallar
- **Önce testleri çalıştırmadan asla silmeyin**
- **Bir seferde bir silme** — Atomik değişiklikler geri almayı kolaylaştırır
- **Emin değilseniz atlayın** — Üretimi bozmaktansa ölü kodu tutmak daha iyidir
- **Temizlerken refactor etmeyin** — Endişeleri ayırın (önce temizle, sonra refactor et)