[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](../id/CONTRIBUTING.md) • Italiano • [日本語](../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)
# 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](#approccio-issue-first), il che significa che tutte le [Pull Request (PR)](#invio-di-una-pull-request) devono prima essere collegate a un'issue di GitHub. Si prega di leggere attentamente questa guida. ## Sommario - [Prima di contribuire](#prima-di-contribuire) - [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo) - [Processo di sviluppo e invio](#processo-di-sviluppo-e-invio) - [Legale](#legale) ## Prima di contribuire ### 1. Codice di condotta Tutti i contributori devono attenersi al nostro [Codice di condotta](./CODE_OF_CONDUCT.md). ### 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](https://discord.gg/roocode) e invia un DM a **Hannes Rudolph (`hrudolph`)**. - **Alternativa:** I contributori esperti possono interagire direttamente tramite i [progetti GitHub](https://github.com/orgs/RooCodeInc/projects/1). ## 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](https://github.com/RooCodeInc/Roo-Code/issues). - **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](https://discord.gg/roocode) 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 - Controlla il [progetto GitHub](https://github.com/orgs/RooCodeInc/projects/1) per le issue "Issue [Non assegnata]". - Per la documentazione, visita [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). ### Segnalazione di bug - Controlla prima le segnalazioni esistenti. - Crea un nuovo bug utilizzando il [modello "Segnalazione di bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 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](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## 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 ``` 2. **Installa le dipendenze:** ``` pnpm install ``` 3. **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](https://discord.gg/roocode). 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.