- **Segnalazioni di bug** - Qualcosa non funziona? Apri una [segnalazione di bug](https://github.com/snapotter-hq/snapotter/issues/new?template=bug_report.yml) con i passaggi per riprodurlo.
- **Richieste di funzionalità** - Hai un'idea? Avvia una [discussione](https://github.com/snapotter-hq/snapotter/discussions/new?category=ideas) così la community può valutarla e votarla.
- **Problemi di traduzione** - Hai notato una traduzione errata o mancante? Apri una [issue di traduzione](https://github.com/snapotter-hq/snapotter/issues/new?template=translation.yml).
- **Problemi nella documentazione** - Qualcosa non torna nella documentazione? Apri una [issue di documentazione](https://github.com/snapotter-hq/snapotter/issues/new?template=documentation.yml).
### Codice (richiede CLA) {#code-requires-cla}
Accettiamo pull request per:
| Tipo | Processo |
|------|---------|
| Correzioni di bug | Apri direttamente una PR (collega la issue se ne esiste una) |
| Nuove traduzioni | Apri direttamente una PR (vedi la [Guida alla traduzione](/it/guide/translations)) |
| Miglioramenti alla documentazione | Apri direttamente una PR |
| Miglioramenti alla copertura dei test | Apri direttamente una PR |
| Nuovi strumenti o funzionalità | Avvia prima una [discussione](https://github.com/snapotter-hq/snapotter/discussions/new?category=ideas); un manutentore converte le idee approvate in una issue tracciata prima che tu scriva il codice |
| Refactor o modifiche all'architettura | Avvia prima una [discussione](https://github.com/snapotter-hq/snapotter/discussions/new?category=ideas) e attendi l'approvazione di un manutentore prima di scrivere il codice |
### Cosa non accetteremo {#what-we-will-not-accept}
- Modifiche ai workflow CI/CD, alla configurazione di rilascio o alla configurazione di linter/compilatore
- PR senza un [Contributor License Agreement](#contributor-license-agreement) firmato
- PR con oltre 400 righe di modifiche (suddividi il lavoro grande in PR più piccole)
- Funzionalità che non sono state prima discusse e approvate
- Modifiche a `packages/ai/` senza discussione preventiva
Prima di poter unire la tua prima PR, devi firmare il nostro [CLA individuale](https://github.com/snapotter-hq/snapotter/blob/main/CLA.md). È un requisito una tantum.
**Perché:** SnapOtter è a doppia licenza (AGPLv3 + commerciale). Il CLA ci concede il diritto di distribuire i tuoi contributi con entrambe le licenze. Mantieni la piena titolarità del copyright sul tuo lavoro.
**Come:** Quando apri la tua prima PR, il bot CLA Assistant commenterà con un link. Fai clic, esamina l'accordo e firma con il tuo account GitHub. Bastano 30 secondi.
Se stai contribuendo per conto del tuo datore di lavoro e questi mantiene i diritti di proprietà intellettuale sul tuo lavoro, contatta contact@snapotter.com per stipulare un CLA aziendale prima di inviare.
7. Attendi che la CI passi e che un manutentore effettui la revisione
### Cosa aspettarsi dalla revisione {#review-expectations}
- Puntiamo a rispondere alle PR entro 7 giorni
- Le PR piccole e mirate vengono revisionate più velocemente
- Se non ricevi risposta entro 7 giorni, lascia un commento per richiamare l'attenzione sul thread
- Potremmo richiedere modifiche, suggerire un approccio diverso o chiudere la PR se non è in linea con la direzione del progetto
### Dopo che la tua PR è stata unita {#after-your-pr-is-merged}
Il tuo contributo sarà incluso nella prossima release e accreditato nel changelog.
## Prime issue adatte ai principianti {#good-first-issues}
Cerchi qualcosa su cui lavorare? Consulta le nostre [good first issue](https://github.com/snapotter-hq/snapotter/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) per attività adatte ai principianti, oppure le [help wanted](https://github.com/snapotter-hq/snapotter/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) per attività più grandi in cui apprezzeremmo l'aiuto della community.
## Stile del codice {#code-style}
- Biome gestisce formattazione e linting (virgolette doppie, punto e virgola, indentazione di 2 spazi)
- L'hook pre-commit esegue automaticamente `biome check --write` sui file in stage
- Se il linter si lamenta, correggi il codice (non modificare la configurazione di Biome)
Per i dettagli completi sull'architettura, consulta la [Guida per sviluppatori](/it/guide/developer).
## Sicurezza {#security}
**Non aprire una PR o una issue pubblica per le vulnerabilità di sicurezza.** Segnalale privatamente tramite i [GitHub Security Advisories](https://github.com/snapotter-hq/snapotter/security/advisories/new) o via email a contact@snapotter.com. Vedi [SECURITY.md](https://github.com/snapotter-hq/snapotter/blob/main/SECURITY.md) per tutti i dettagli.
