Skip to content

Latest commit

 

History

History
138 lines (88 loc) · 5.29 KB

CONTRIBUTING.md

File metadata and controls

138 lines (88 loc) · 5.29 KB

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

  1. Fork & Clone:
git clone https://github.com/YOUR_USERNAME/Roo-Code.git
  1. Install Dependencies:
pnpm install
  1. 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.