[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 • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md)
[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
Berkontribusi pada Roo Code
Roo Code adalah proyek yang didorong oleh komunitas, dan kami sangat menghargai setiap kontribusi. Untuk memperlancar kolaborasi, kami beroperasi berdasarkan pendekatan Issue-First, yang berarti semua Pull Request (PR) harus terlebih dahulu ditautkan ke GitHub Issue. Harap tinjau panduan ini dengan cermat.
Daftar Isi
Sebelum Kamu Berkontribusi
1. Kode Etik
Semua kontributor harus mematuhi Kode Etik kami.
2. Peta Jalan Proyek
Peta jalan kami memandu arah proyek. Selaraskan kontribusi kamu dengan tujuan utama ini:
Keandalan Utama
- Pastikan pengeditan diff dan eksekusi perintah secara konsisten dapat diandalkan.
- Kurangi titik gesekan yang menghalangi penggunaan rutin.
- Jamin operasi yang lancar di semua lokal dan platform.
- Perluas dukungan yang kuat untuk berbagai penyedia dan model AI.
Pengalaman Pengguna yang Ditingkatkan
- Sederhanakan UI/UX untuk kejelasan dan intuitivitas.
- Terus tingkatkan alur kerja untuk memenuhi ekspektasi tinggi yang dimiliki developer terhadap tools penggunaan sehari-hari.
Memimpin dalam Performa Agen
- Tetapkan benchmark evaluasi komprehensif (evals) untuk mengukur produktivitas dunia nyata.
- Permudah semua orang untuk menjalankan dan menafsirkan evals ini.
- Kirimkan perbaikan yang menunjukkan peningkatan jelas dalam skor eval.
Sebutkan keselarasan dengan area ini di PR kamu.
3. Bergabung dengan Komunitas Roo Code
- Utama: Bergabunglah dengan Discord kami dan DM Hannes Rudolph (
hrudolph).
- Alternatif: Kontributor berpengalaman dapat berinteraksi langsung melalui GitHub Projects.
Mencari & Merencanakan Kontribusi Kamu
Jenis Kontribusi
- Perbaikan Bug: Mengatasi masalah kode.
- Fitur Baru: Menambahkan fungsionalitas.
- Dokumentasi: Meningkatkan panduan dan kejelasan.
Pendekatan Issue-First
Semua kontribusi harus dimulai dengan GitHub Issue.
- Periksa isu yang ada: Cari di GitHub Issues.
- Buat isu: Gunakan template yang sesuai:
- Bug: Template "Bug Report".
- Fitur: Template "Detailed Feature Proposal". Persetujuan diperlukan sebelum memulai.
- Klaim isu: Beri komentar dan tunggu penugasan resmi.
PR tanpa isu yang disetujui dapat ditutup.
Memutuskan Apa yang Akan Dikerjakan
Melaporkan Bug
Proses Pengembangan & Pengiriman
Setup Pengembangan
Fork & Clone:
git clone https://github.com/YOUR_USERNAME/Roo-Code.git
Install Dependencies:
pnpm install
Debugging: Buka dengan VS Code (F5).
Panduan Menulis Kode
- Satu PR yang fokus per fitur atau perbaikan.
- Ikuti praktik terbaik ESLint dan TypeScript.
- Tulis commit yang jelas dan deskriptif yang merujuk pada isu (misalnya,
Fixes #123).
- Sediakan pengujian menyeluruh (
npm test).
- Rebase ke branch
main terbaru sebelum pengiriman.
Mengirimkan Pull Request
- Mulai sebagai Draft PR jika mencari feedback awal.
- Jelaskan perubahan kamu dengan jelas mengikuti Template Pull Request.
- Sediakan screenshot/video untuk perubahan UI.
- Tunjukkan jika pembaruan dokumentasi diperlukan.
Kebijakan Pull Request
- Harus merujuk pada isu yang telah disetujui dan ditugaskan sebelumnya.
- PR tanpa kepatuhan terhadap kebijakan dapat ditutup.
- PR harus lulus tes CI, selaras dengan peta jalan, dan memiliki dokumentasi yang jelas.
Proses Review
- Triage Harian: Pemeriksaan cepat oleh maintainer.
- Review Mendalam Mingguan: Penilaian komprehensif.
- Iterasi segera berdasarkan feedback.
Legal
Dengan berkontribusi, kamu setuju kontribusi kamu akan dilisensikan di bawah Lisensi Apache 2.0, konsisten dengan lisensi Roo Code.