Skip to content

Latest commit

 

History

History
138 lines (88 loc) · 5.59 KB

CONTRIBUTING.md

File metadata and controls

138 lines (88 loc) · 5.59 KB

Roo Code'a Katkıda Bulunma

Roo Code, topluluk odaklı bir projedir ve her katkıyı çok önemsiyoruz. İşbirliğini kolaylaştırmak için Issue-First yaklaşımıyla çalışıyoruz; bu, tüm Pull Request'lerin (PR'lar) önce bir GitHub Issue'ya bağlanması gerektiği anlamına gelir. Lütfen bu rehberi dikkatlice incele.

İçindekiler

Katkıdan Önce

1. Davranış Kuralları

Tüm katkı sağlayanlar Davranış Kuralları'na uymalıdır.

2. Proje Yol Haritası

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

Güvenilirlik Öncelikli

  • Diff düzenleme ve komut yürütme işlemlerinin sürekli olarak güvenilir olmasını sağlamak
  • Düzenli kullanımı engelleyen sürtünme noktalarını azaltmak
  • Tüm dillerde ve platformlarda sorunsuz çalışmayı garanti etmek
  • Çok çeşitli yapay zeka sağlayıcıları ve modelleri için güçlü desteği genişletmek

Geliştirilmiş Kullanıcı Deneyimi

  • Daha fazla netlik ve sezgisellik için kullanıcı arayüzünü basitleştirmek
  • Geliştiricilerin yüksek beklentilerini karşılamak üzere iş akışını sürekli iyileştirmek

Ajan Performansında Liderlik

  • Gerçek dünyadaki üretkenliği ölçmek için kapsamlı değerlendirme kriterleri (evals) oluşturmak
  • Herkesin bu değerlendirmeleri kolayca çalıştırıp yorumlamasını sağlamak
  • Değerlendirme puanlarında net artışlar gösteren iyileştirmeler sunmak

PR'larında bu alanlarla olan bağlantıyı belirt.

3. Roo Code Topluluğuna Katıl

  • Ana yöntem: Discord'umuza katıl ve Hannes Rudolph (hrudolph)'a DM gönder.
  • Alternatif: Deneyimli katkı sağlayanlar GitHub Projects üzerinden doğrudan katılabilir.

Katkı Bulma & Planlama

Katkı Türleri

  • Hata düzeltmeleri: Koddaki sorunları çözmek.
  • Yeni özellikler: Yeni işlevsellik eklemek.
  • Dokümantasyon: Rehberleri geliştirmek ve netleştirmek.

Issue-First Yaklaşımı

Tüm katkılar bir GitHub Issue ile başlamalıdır.

  • Mevcut issue'ları kontrol et: GitHub Issues'da ara.
  • Issue oluştur: Uygun şablonları kullan:
    • Hatalar: "Bug Report" şablonu.
    • Özellikler: "Detailed Feature Proposal" şablonu. Başlamadan önce onay gerekir.
  • Issue'ları sahiplen: Yorum yap ve resmi atamayı bekle.

Onaylanmış issue'lara bağlı olmayan PR'lar kapatılabilir.

Ne Üzerinde Çalışacağına Karar Verme

Hata veya Sorun Bildirme

Geliştirme & Gönderim Süreci

Geliştirme Ortamı Kurulumu

  1. Fork & Clone:
git clone https://github.com/KULLANICI_ADIN/Roo-Code.git
  1. Bağımlılıkları yükle:
npm run install:all
  1. Hata ayıklama: VS Code'da F5 ile aç.

Kod Yazma Rehberi

  • Her özellik veya düzeltme için odaklı bir PR.
  • ESLint ve TypeScript en iyi uygulamalarını takip et.
  • Issue'lara referans veren açık, açıklayıcı commit mesajları yaz (örn. Fixes #123).
  • Kapsamlı testler sağla (npm test).
  • Göndermeden önce en son main branch'i üzerine rebase yap.

Pull Request Gönderme

  • Erken geri bildirim istiyorsan taslak PR olarak başla.
  • Pull Request Şablonunu takip ederek değişikliklerini açıkça tanımla.
  • UI değişiklikleri için ekran görüntüleri/videolar sağla.
  • Dokümantasyon güncellemeleri gerekip gerekmediğini belirt.

Pull Request Politikası

  • Önceden onaylanmış ve atanmış issue'lara referans vermelidir.
  • Politikaya uymayan PR'lar kapatılabilir.
  • PR'lar CI testlerini geçmeli, yol haritasıyla uyumlu olmalı ve net dokümantasyona sahip olmalıdır.

İnceleme Süreci

  • Günlük triyaj: Maintainer'lar tarafından hızlı kontroller.
  • Haftalık detaylı inceleme: Kapsamlı değerlendirme.
  • Geri bildirim temelinde hızla yinele.

Yasal

Pull request göndererek, katkılarının Roo Code'un lisanslamasıyla tutarlı olarak Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursun.