ECC/docs/tr/TERMINOLOGY.md

# 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