Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
141 lines (92 loc) · 6.44 KB

CONTRIBUTING.md

File metadata and controls

141 lines (92 loc) · 6.44 KB

Contribuire a Roo Code

Roo Code è un progetto guidato dalla comunità e apprezziamo profondamente ogni contributo. Per semplificare la collaborazione, operiamo su una base Issue-First, il che significa che tutte le Pull Request (PR) devono prima essere collegate a un'issue di GitHub. Si prega di leggere attentamente questa guida.

Sommario

Prima di contribuire

1. Codice di condotta

Tutti i contributori devono attenersi al nostro Codice di condotta.

2. Roadmap del progetto

La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi a questi obiettivi chiave:

Affidabilità prima di tutto

  • Assicurati che la modifica dei diff e l'esecuzione dei comandi siano costantemente affidabili.
  • Riduci i punti di frizione che scoraggiano l'uso regolare.
  • Garantisci un funzionamento fluido in tutte le localizzazioni e piattaforme.
  • Espandi un supporto solido per un'ampia varietà di provider e modelli di intelligenza artificiale.

Esperienza utente migliorata

  • Semplifica l'interfaccia utente/esperienza utente per chiarezza e intuitività.
  • Migliora continuamente il flusso di lavoro per soddisfare le elevate aspettative che gli sviluppatori hanno per gli strumenti di uso quotidiano.

Leader nelle prestazioni degli agenti

  • Stabilisci benchmark di valutazione completi (eval) per misurare la produttività nel mondo reale.
  • Semplifica per tutti l'esecuzione e l'interpretazione di queste valutazioni.
  • Fornisci miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione.

Menziona l'allineamento con queste aree nelle tue PR.

3. Unisciti alla community di Roo Code

  • Principale: Unisciti al nostro Discord e invia un DM a Hannes Rudolph (hrudolph).
  • Alternativa: I contributori esperti possono interagire direttamente tramite i progetti GitHub.

Trovare e pianificare il tuo contributo

Tipi di contributi

  • Correzioni di bug: risoluzione di problemi di codice.
  • Nuove funzionalità: aggiunta di funzionalità.
  • Documentazione: miglioramento di guide e chiarezza.

Approccio Issue-First

Tutti i contributi iniziano con un'issue di GitHub utilizzando i nostri modelli snelli.

  • Controlla le issue esistenti: cerca nelle issue di GitHub.
  • Crea un'issue utilizzando:
    • Miglioramenti: modello "Richiesta di miglioramento" (linguaggio semplice incentrato sul vantaggio per l'utente).
    • Bug: modello "Segnalazione di bug" (riproduzione minima + previsto vs effettivo + versione).
  • Vuoi lavorarci? Commenta "Rivendico" sull'issue e invia un DM a Hannes Rudolph (hrudolph) su Discord per essere assegnato. L'assegnazione verrà confermata nel thread.
  • Le PR devono essere collegate all'issue. Le PR non collegate possono essere chiuse.

Decidere su cosa lavorare

Segnalazione di bug

  • Controlla prima le segnalazioni esistenti.
  • Crea un nuovo bug utilizzando il modello "Segnalazione di bug" con:
    • Passaggi di riproduzione chiari e numerati
    • Risultato previsto vs effettivo
    • Versione di Roo Code (obbligatoria); provider/modello di intelligenza artificiale se pertinente
  • Problemi di sicurezza: segnala in privato tramite avvisi di sicurezza.

Processo di sviluppo e invio

Configurazione dello sviluppo

  1. Esegui il fork e clona:
git clone https://github.com/TUO_NOME_UTENTE/Roo-Code.git
  1. Installa le dipendenze:
pnpm install
  1. Debug: apri con VS Code (F5).

Linee guida per la scrittura del codice

  • Una PR mirata per funzionalità o correzione.
  • Segui le migliori pratiche di ESLint e TypeScript.
  • Scrivi commit chiari e descrittivi che facciano riferimento alle issue (ad es. Risolve #123).
  • Fornisci test approfonditi (npm test).
  • Esegui il rebase sul ramo main più recente prima dell'invio.

Invio di una Pull Request

  • Inizia come bozza di PR se cerchi un feedback iniziale.
  • Descrivi chiaramente le tue modifiche seguendo il modello di Pull Request.
  • Collega l'issue nella descrizione/titolo della PR (ad es. "Risolve #123").
  • Fornisci screenshot/video per le modifiche all'interfaccia utente.
  • Indica se sono necessari aggiornamenti alla documentazione.

Politica sulle Pull Request

  • Deve fare riferimento a un'issue di GitHub assegnata. Per essere assegnato: commenta "Rivendico" sull'issue e invia un DM a Hannes Rudolph (hrudolph) su Discord. L'assegnazione verrà confermata nel thread.
  • Le PR non collegate possono essere chiuse.
  • Le PR devono superare i test di integrazione continua, essere in linea con la roadmap e avere una documentazione chiara.

Processo di revisione

  • Triage giornaliero: controlli rapidi da parte dei manutentori.
  • Revisione approfondita settimanale: valutazione completa.
  • Itera prontamente in base al feedback.

Legale

Contribuendo, accetti che i tuoi contributi siano concessi in licenza con la licenza Apache 2.0, in coerenza con la licenza di Roo Code.