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

184
docs/tr/TERMINOLOGY.md Normal file
View File

@@ -0,0 +1,184 @@
# Terminoloji Tablosu (Terminology Glossary)
Bu doküman Türkçe çevirilerin terminoloji karşılıklarını kayıt altına alarak çeviri tutarlılığını sağlar.
## Durum Açıklaması
- **Onaylandı (Confirmed)**: Onaylanmış çeviri
- **Beklemede (Pending)**: İnceleme bekleyen çeviri
---
## Terminoloji Tablosu
| English | tr | Durum | Notlar |
|---------|-------|------|------|
| Agent | Agent | Onaylandı | İngilizce tutulur |
| Hook | Hook | Onaylandı | İngilizce tutulur |
| Plugin | Plugin | Onaylandı | İngilizce tutulur |
| Token | Token | Onaylandı | İngilizce tutulur |
| Skill | Skill | Onaylandı | İngilizce tutulur |
| Command | Command | Onaylandı | İngilizce tutulur |
| Rule | Rule | Onaylandı | İngilizce tutulur |
| Harness | Harness | Onaylandı | İngilizce tutulur |
| TDD (Test-Driven Development) | TDD (Test Odaklı Geliştirme) | Onaylandı | İlk kullanımda açılır |
| E2E (End-to-End) | E2E (Uçtan Uca) | Onaylandı | İlk kullanımda açılır |
| API | API | Onaylandı | İngilizce tutulur |
| CLI | CLI | Onaylandı | İngilizce tutulur |
| IDE | IDE | Onaylandı | İngilizce tutulur |
| MCP (Model Context Protocol) | MCP | Onaylandı | İngilizce tutulur |
| Workflow | İş akışı / Workflow | Onaylandı | Bağlama göre |
| Codebase | Kod tabanı / Codebase | Onaylandı | Bağlama göre |
| Coverage | Kapsam / Coverage | Onaylandı | Test bağlamında |
| Build | Build | Onaylandı | İngilizce tutulur |
| Debug | Debug | Onaylandı | İngilizce tutulur |
| Deploy | Deploy / Dağıtım | Onaylandı | Bağlama göre |
| Commit | Commit | Onaylandı | Git terimi, İngilizce tutulur |
| PR (Pull Request) | PR | Onaylandı | İngilizce tutulur |
| Branch | Branch | Onaylandı | Git terimi, İngilizce tutulur |
| Merge | Merge | Onaylandı | Git terimi, İngilizce tutulur |
| Repository | Repository | Onaylandı | İngilizce tutulur |
| Fork | Fork | Onaylandı | İngilizce tutulur |
| Supabase | Supabase | - | Ürün adı korunur |
| Redis | Redis | - | Ürün adı korunur |
| Playwright | Playwright | - | Ürün adı korunur |
| TypeScript | TypeScript | - | Dil adı korunur |
| JavaScript | JavaScript | - | Dil adı korunur |
| Go/Golang | Go | - | Dil adı korunur |
| Python | Python | - | Dil adı korunur |
| Java | Java | - | Dil adı korunur |
| Kotlin | Kotlin | - | Dil adı korunur |
| Swift | Swift | - | Dil adı korunur |
| Rust | Rust | - | Dil adı korunur |
| PHP | PHP | - | Dil adı korunur |
| Perl | Perl | - | Dil adı korunur |
| React | React | - | Framework adı korunur |
| Next.js | Next.js | - | Framework adı korunur |
| Vue | Vue | - | Framework adı korunur |
| Django | Django | - | Framework adı korunur |
| Laravel | Laravel | - | Framework adı korunur |
| PostgreSQL | PostgreSQL | - | Ürün adı korunur |
| SQLite | SQLite | - | Ürün adı korunur |
| RLS (Row Level Security) | RLS (Satır Düzeyi Güvenlik) | Onaylandı | İlk kullanımda açılır |
| OWASP | OWASP | - | İngilizce tutulur |
| XSS | XSS | - | İngilizce tutulur |
| SQL Injection | SQL Injection | Onaylandı | İngilizce tutulur |
| CSRF | CSRF | - | İngilizce tutulur |
| Refactor | Refactor / Yeniden yapılandırma | Onaylandı | Bağlama göre |
| Dead Code | Dead code | Onaylandı | İngilizce tutulur |
| Lint/Linter | Lint | Onaylandı | İngilizce tutulur |
| Code Review | Code review | Onaylandı | İngilizce tutulur |
| Security Review | Güvenlik incelemesi | Onaylandı | |
| Best Practices | En iyi uygulamalar | Onaylandı | |
| Edge Case | Edge case | Onaylandı | İngilizce tutulur |
| Happy Path | Happy path | Onaylandı | İngilizce tutulur |
| Fallback | Fallback | Onaylandı | İngilizce tutulur |
| Cache | Cache | Onaylandı | İngilizce tutulur |
| Queue | Queue | Onaylandı | İngilizce tutulur |
| Pagination | Pagination | Onaylandı | İngilizce tutulur |
| Cursor | Cursor | Onaylandı | İngilizce tutulur |
| Index | Index | Onaylandı | İngilizce tutulur |
| Schema | Schema | Onaylandı | İngilizce tutulur |
| Migration | Migration | Onaylandı | İngilizce tutulur |
| Transaction | Transaction | Onaylandı | İngilizce tutulur |
| Concurrency | Eşzamanlılık / Concurrency | Onaylandı | Bağlama göre |
| Goroutine | Goroutine | - | Go terimi korunur |
| Channel | Channel | Onaylandı | Go bağlamında korunur |
| Mutex | Mutex | - | İngilizce tutulur |
| Interface | Interface | Onaylandı | İngilizce tutulur |
| Struct | Struct | - | Go terimi korunur |
| Mock | Mock | Onaylandı | Test terimi korunur |
| Stub | Stub | Onaylandı | Test terimi korunur |
| Fixture | Fixture | Onaylandı | Test terimi korunur |
| Assertion | Assertion | Onaylandı | İngilizce tutulur |
| Snapshot | Snapshot | Onaylandı | İngilizce tutulur |
| Trace | Trace | Onaylandı | İngilizce tutulur |
| Artifact | Artifact | Onaylandı | İngilizce tutulur |
| CI/CD | CI/CD | - | İngilizce tutulur |
| Pipeline | Pipeline | Onaylandı | İngilizce tutulur |
| Container | Container | Onaylandı | İngilizce tutulur |
| Docker | Docker | - | Ürün adı korunur |
| Kubernetes | Kubernetes | - | Ürün adı korunur |
| Sandbox | Sandbox | Onaylandı | İngilizce tutulur |
| Evaluation / Eval | Eval | Onaylandı | İngilizce tutulur |
| Prompt | Prompt | Onaylandı | İngilizce tutulur |
| Context | Context / Bağlam | Onaylandı | Bağlama göre |
| Subagent | Subagent | Onaylandı | İngilizce tutulur |
| Orchestration | Orkestrasyon | Onaylandı | |
| Checkpoint | Checkpoint | Onaylandı | İngilizce tutulur |
| Verification Loop | Verification loop | Onaylandı | İngilizce tutulur |
| Observer | Observer | Onaylandı | İngilizce tutulur |
| Session | Session / Oturum | Onaylandı | Bağlama göre |
| State | State / Durum | Onaylandı | Bağlama göre |
| Memory | Memory / Bellek | Onaylandı | Bağlama göre |
| Instinct | Instinct | Onaylandı | İngilizce tutulur |
| Pattern | Pattern / Desen | Onaylandı | Bağlama göre |
| Worktree | Worktree | Onaylandı | Git terimi, İngilizce tutulur |
| Pass@k | Pass@k | - | Metrik adı korunur |
| Grader | Grader | Onaylandı | İngilizce tutulur |
| Hot-load | Hot-load | Onaylandı | İngilizce tutulur |
| Cascade | Cascade | Onaylandı | İngilizce tutulur |
| Throttling | Throttling | Onaylandı | İngilizce tutulur |
| Sanitization | Sanitizasyon | Onaylandı | |
| CVE | CVE | - | İngilizce tutulur |
| AgentShield | AgentShield | - | Ürün adı korunur |
| NanoClaw | NanoClaw | - | Ürün adı korunur |
| ECC Tools | ECC Tools | - | Ürün adı korunur |
---
## Çeviri İlkeleri
1. **Ürün Adları**: İngilizce tutulur (Supabase, Redis, Playwright, AgentShield)
2. **Programlama Dilleri**: İngilizce tutulur (TypeScript, Go, JavaScript, Python)
3. **Framework Adları**: İngilizce tutulur (React, Next.js, Vue, Django)
4. **Teknik Kısaltmalar**: İngilizce tutulur (API, CLI, IDE, MCP, TDD, E2E, CI/CD)
5. **Git Terimleri**: Çoğunlukla İngilizce tutulur (commit, PR, fork, branch, merge)
6. **ECC Terimleri**: İngilizce tutulur (agent, hook, skill, command, rule, harness)
7. **Kod İçeriği**: Çevrilmez (değişken adları, fonksiyon adları orijinal haliyle, açıklama yorumları çevrilir)
8. **İlk Kullanım**: Kısaltmalar ilk kullanımda açılır
9. **Bağlamsal Terimler**: Bazı terimler bağlama göre Türkçe veya İngilizce kullanılır (workflow, codebase, context, vb.)
---
## Türkçe Çeviri Notları
### Neden Çoğu Terim İngilizce?
Yazılım geliştirme ekosisteminde, özellikle AI agent harness sistemlerinde kullanılan terimler için Türkçe karşılıklar:
1. **Tam karşılık vermez**: Örneğin "agent" kelimesinin Türkçe karşılığı olan "ajan" veya "temsilci" teknik bağlamda farklı anlamlara gelebilir.
2. **Ekosistem bütünlüğü**: Geliştiriciler bu terimleri İngilizce olarak öğreniyor ve kullanıyor. Türkçeleştirmek kafa karışıklığına yol açabilir.
3. **Dokümantasyon uyumu**: Orijinal Claude Code dokümantasyonu ve topluluk kaynaklarıyla uyum için İngilizce terimler korunur.
4. **Kod-doküman tutarlılığı**: Kod içinde bu terimler İngilizce kullanıldığından, dokümantasyonda da aynı terimleri kullanmak tutarlılık sağlar.
### Bağlamsal Kullanım
Bazı terimler bağlama göre Türkçe veya İngilizce kullanılır:
- **Workflow**: Genel anlatımda "iş akışı", teknik bağlamda "workflow"
- **Context**: Genel anlatımda "bağlam", teknik bağlamda "context"
- **Session**: Genel anlatımda "oturum", teknik bağlamda "session"
- **Deploy**: Fiil olarak kullanıldığında "dağıtım yapmak", isim olarak "deploy"
### Telaffuz Rehberi (Opsiyonel)
Türkçe konuşurken yaygın kullanılan telaffuzlar:
- **Agent**: /eycent/ (İngilizce telaffuz)
- **Hook**: /huk/ (İngilizce telaffuz)
- **Skill**: /skil/ (İngilizce telaffuz)
- **Command**: /komand/ veya /kumand/
- **Build**: /bild/
- **Debug**: /dibag/
- **Cache**: /keş/
- **Pipeline**: /payplayn/ veya /paypalayn/
---
## Güncelleme Geçmişi
- 2026-03-22: İlk sürüm oluşturuldu, tüm çeviri dosyalarında kullanılan terimler derlendi