Skip to content

Latest commit

 

History

History
138 lines (88 loc) · 5.58 KB

CONTRIBUTING.md

File metadata and controls

138 lines (88 loc) · 5.58 KB

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

Segnalare bug

Processo di sviluppo e invio

Configurazione dello sviluppo

  1. Fork & Clona:
git clone https://github.com/TUO_USERNAME/Roo-Code.git
  1. Installa le dipendenze:
npm run install:all
  1. 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 main più 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.