<div align="center">
<sub>

[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md)

</sub>
<sub>

[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • <b>Türkçe</b> • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)

</sub>
</div>

# Zoo Code'a Katkıda Bulunma

Zoo Code topluluk tarafından yürütülen bir projedir ve her katkıyı derinden takdir ediyoruz. İşbirliğini kolaylaştırmak için [Önce Sorun Yaklaşımı](#önce-sorun-yaklaşımı) temelinde çalışıyoruz, bu da tüm [Çekme İsteklerinin (PR'ler)](#pull-request-guidelines) önce bir GitHub Sorununa bağlanması gerektiği anlamına gelir. Lütfen bu kılavuzu dikkatlice inceleyin.

## İçindekiler

- [Katkıda Bulunmadan Önce](#katkıda-bulunmadan-önce)
- [Katkınızı Bulma ve Planlama](#katkınızı-bulma-ve-planlama)
- [Geliştirme ve Gönderme Süreci](#geliştirme-ve-gönderme-süreci)
- [Yasal](#yasal)

## Katkıda Bulunmadan Önce

### 1. Davranış Kuralları

Tüm katkıda bulunanlar [Davranış Kurallarımıza](./CODE_OF_CONDUCT.md) uymalıdır.

### 2. Proje Yol Haritası

Yol haritamız projenin yönünü belirler. Katkılarınızı bu temel hedeflerle hizalayın:

### Önce Güvenilirlik

- Fark düzenleme ve komut yürütmenin tutarlı bir şekilde güvenilir olduğundan emin olun.
- Düzenli kullanımı caydıran sürtünme noktalarını azaltın.
- Tüm yerellerde ve platformlarda sorunsuz çalışmayı garanti edin.
- Çok çeşitli yapay zeka sağlayıcıları ve modelleri için sağlam desteği genişletin.

### Geliştirilmiş Kullanıcı Deneyimi

- Netlik ve sezgisellik için kullanıcı arayüzünü/kullanıcı deneyimini kolaylaştırın.
- Geliştiricilerin günlük kullanım araçlarından beklentilerini karşılamak için iş akışını sürekli iyileştirin.

### Ajan Performansında Liderlik

- Gerçek dünya verimliliğini ölçmek için kapsamlı değerlendirme ölçütleri (eval'ler) oluşturun.
- Herkesin bu değerlendirmeleri kolayca çalıştırmasını ve yorumlamasını sağlayın.
- Değerlendirme puanlarında net artışlar gösteren iyileştirmeler gönderin.

PR'lerinizde bu alanlarla uyumu belirtin.

### 3. Zoo Code topluluğuna katıl

- **Discord:** [Discord](https://discord.gg/VxfP4Vx3gX) sunucumuza katıl.
- **Reddit:** [Reddit](https://www.reddit.com/r/ZooCode/) topluluğumuza katıl.

## Katkınızı Bulma ve Planlama

### Katkı Türleri

- **Hata Düzeltmeleri:** kod sorunlarını giderme.
- **Yeni Özellikler:** işlevsellik ekleme.
- **Belgelendirme:** kılavuzları ve netliği iyileştirme.

### Önce Sorun Yaklaşımı

Tüm katkılar, basit şablonlarımızı kullanarak bir GitHub Sorunu ile başlar.

- **Mevcut sorunları kontrol edin**: [GitHub Sorunları](https://github.com/Zoo-Code-Org/Zoo-Code/issues)nda arama yapın.
- **Bir sorun oluşturun**:
    - **İyileştirmeler:** "İyileştirme İsteği" şablonu (kullanıcı yararına odaklanan sade bir dil).
    - **Hatalar:** "Hata Raporu" şablonu (minimum yeniden oluşturma + beklenen vs gerçek + sürüm).
- **Üzerinde çalışmak ister misiniz?** Soruna "Talep ediyorum" yorumu yapın ve atanmak için [Discord](https://discord.gg/VxfP4Vx3gX) üzerinden çekirdek ekiple iletişime geçin. Atama, başlıkta teyit edilecektir.
- **PR'ler soruna bağlanmalıdır.** Bağlantısız PR'ler kapatılabilir.

### Ne Üzerinde Çalışılacağına Karar Verme

- Issue bulmak için [GitHub Issues sayfasına](https://github.com/Zoo-Code-Org/Zoo-Code/issues) bak.
- Belgeler için [Zoo Code Belgeleri](https://github.com/Zoo-Code-Org/Zoo-Code-Docs)ni ziyaret edin.

### Hataları Bildirme

- Önce mevcut raporları kontrol edin.
- Aşağıdakilerle ["Hata Raporu" şablonunu](https://github.com/Zoo-Code-Org/Zoo-Code/issues/new/choose) kullanarak yeni bir hata oluşturun:
    - Açık, numaralandırılmış yeniden oluşturma adımları
    - Beklenen vs gerçek sonuç
    - Zoo Code sürümü (gerekli); ilgiliyse API sağlayıcısı/modeli
- **Güvenlik sorunları**: [Güvenlik tavsiyeleri](https://github.com/Zoo-Code-Org/Zoo-Code/security/advisories/new) aracılığıyla özel olarak bildirin.

## Geliştirme ve Gönderme Süreci

### Geliştirme Kurulumu

1. **Çatallayın ve Klonlayın:**

```
git clone https://github.com/YOUR_USERNAME/Zoo-Code.git
```

2. **Bağımlılıkları Yükleyin:**

```
pnpm install
```

3. **Hata Ayıklama:** VS Code (`F5`) ile açın.

### Kod Yazma Yönergeleri

- Her özellik veya düzeltme için odaklanmış bir PR.
- ESLint ve TypeScript en iyi uygulamalarını takip edin.
- Sorunlara atıfta bulunan açık, açıklayıcı taahhütler yazın (ör. `Düzeltmeler #123`).
- Kapsamlı testler sağlayın (`npm test`).
- Göndermeden önce en son `main` dalına yeniden temel alın.

<a id="pull-request-guidelines"></a>

### Bir Çekme İsteği Gönderme

- Erken geri bildirim arıyorsanız **Taslak PR** olarak başlayın.
- Çekme İsteği Şablonunu izleyerek değişikliklerinizi açıkça tanımlayın.
- PR açıklamasında/başlığında sorunu bağlayın (ör. "Düzeltmeler #123").
- Kullanıcı arayüzü değişiklikleri için ekran görüntüleri/videolar sağlayın.
- Belge güncellemelerinin gerekli olup olmadığını belirtin.

### Çekme İsteği Politikası

- Atanmış bir GitHub Sorununa atıfta bulunmalıdır. Atanmak için: soruna "Talep ediyorum" yorumu yapın ve [Discord](https://discord.gg/VxfP4Vx3gX) üzerinden çekirdek ekiple iletişime geçin. Atama, başlıkta teyit edilecektir.
- Bağlantısız PR'ler kapatılabilir.
- PR'ler CI testlerini geçmeli, yol haritasıyla uyumlu olmalı ve net belgelere sahip olmalıdır.

### İnceleme Süreci

- **Günlük Triyaj:** Sürdürücüler tarafından hızlı kontroller.
- **Haftalık Derinlemesine İnceleme:** Kapsamlı değerlendirme.
- Geri bildirime göre **hızlı bir şekilde yineleyin**.

## Yasal

Katkıda bulunarak, katkılarınızın Zoo Code'un lisanslamasıyla tutarlı olan Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursunuz.
