Roo-Code/locales/it/CONTRIBUTING.md

_{[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, 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
• Trovare e pianificare il tuo contributo
• Processo di sviluppo e invio
• Legale

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

• Controlla il progetto GitHub per le issue "Issue [Non assegnata]".
• Per la documentazione, visita Roo Code Docs.

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
   

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. 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.