5.5 KiB
English • Català • Deutsch • Español • Français • हिंदी • Italiano • Nederlands • Русский
日本語 • 한국어 • Polski • Português (BR) • Türkçe • Tiếng Việt • 简体中文 • 繁體中文
Contribuire a Roo Code
Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contributo. Per semplificare la collaborazione, operiamo secondo un approccio Issue-First, il che significa che tutte le Pull Request (PR) devono prima essere collegate a una Issue GitHub. Ti preghiamo di leggere attentamente questa guida.
Indice
Prima di contribuire
1. Codice di condotta
Tutti i collaboratori devono rispettare il nostro Codice di condotta.
2. Roadmap del progetto
La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi con questi obiettivi chiave:
Affidabilità prima di tutto
- Garantire che l'editing delle differenze e l'esecuzione dei comandi siano costantemente affidabili
- Ridurre i punti di attrito che scoraggiano l'uso regolare
- Garantire un funzionamento fluido in tutte le lingue e su tutte le piattaforme
- Ampliare il supporto robusto per una vasta gamma di provider e modelli di IA
Esperienza utente migliorata
- Semplificare l'interfaccia utente per maggiore chiarezza e intuitività
- Migliorare continuamente il flusso di lavoro per soddisfare le elevate aspettative degli sviluppatori
Leadership nelle prestazioni degli agenti
- Stabilire parametri di valutazione completi (evals) per misurare la produttività nel mondo reale
- Rendere facile per tutti eseguire e interpretare queste valutazioni
- Fornire miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione
Menziona l'allineamento con queste aree nelle tue PR.
3. Unisciti alla community Roo Code
- Principale: Unisciti al nostro Discord e invia un DM a Hannes Rudolph (
hrudolph). - Alternativa: I collaboratori esperti possono partecipare direttamente tramite GitHub Projects.
Trovare e pianificare il tuo contributo
Tipi di contributi
- Correzione bug: Risolvere problemi nel codice.
- Nuove funzionalità: Aggiungere nuove funzionalità.
- Documentazione: Migliorare guide e chiarezza.
Approccio Issue-First
Tutti i contributi devono iniziare con una Issue GitHub.
- Verificare le issue esistenti: Cerca su GitHub Issues.
- Creare una issue: Usa i template appropriati:
- Bug: Template "Bug Report".
- Funzionalità: Template "Detailed Feature Proposal". Approvazione richiesta prima di iniziare.
- Reclamare issue: Commenta e attendi l'assegnazione ufficiale.
Le PR senza issue approvate potrebbero essere chiuse.
Decidere su cosa lavorare
- Controlla il Progetto GitHub per "Good First Issues" non assegnate.
- Per la documentazione, visita Roo Code Docs.
Segnalare bug
- Controlla prima i report esistenti.
- Crea nuovi report di bug usando il template "Bug Report".
- Problemi di sicurezza: Segnala privatamente tramite security advisories.
Processo di sviluppo e invio
Configurazione dello sviluppo
- Fork & Clona:
git clone https://github.com/TUO_USERNAME/Roo-Code.git
- Installa le dipendenze:
npm run install:all
- Debug: Apri con VS Code (
F5).
Linee guida per scrivere codice
- Una PR focalizzata per funzionalità o correzione.
- Segui le best practice di ESLint e TypeScript.
- Scrivi commit chiari e descrittivi che fanno riferimento alle issue (es.
Fixes #123). - Fornisci test approfonditi (
npm test). - Fai rebase sul branch
mainpiù recente prima dell'invio.
Inviare una Pull Request
- Inizia come PR in bozza se cerchi feedback anticipato.
- Descrivi chiaramente le tue modifiche seguendo il Template di Pull Request.
- Fornisci screenshot/video per modifiche UI.
- Indica se sono necessari aggiornamenti alla documentazione.
Politica di Pull Request
- Deve fare riferimento a issue pre-approvate e assegnate.
- Le PR che non rispettano la politica potrebbero essere chiuse.
- Le PR dovrebbero superare i test CI, allinearsi con la roadmap e avere documentazione chiara.
Processo di revisione
- Triage quotidiano: Controlli rapidi da parte dei maintainer.
- Revisione settimanale approfondita: Valutazione completa.
- Itera rapidamente in base al feedback.
Legale
Inviando una pull request, accetti che i tuoi contributi siano concessi in licenza sotto la Licenza Apache 2.0, in linea con la licenza di Roo Code.