Vai al contenuto

Contribuire al progetto

Jarvis è un progetto open source community-driven. Ogni contributo conta.

Modi per contribuire

  • Segnalare bug

    Apri una GitHub issue con un caso di riproduzione minimale.

  • Proporre feature

    Apri una discussion prima di scrivere codice, soprattutto per idee importanti.

  • Migliorare la documentazione

    Refusi, esempi mancanti, traduzioni IT ↔ EN.

  • Aggiungere una lingua

    Oggi supportiamo IT + EN. Ogni nuova lingua è benvenuta.

  • Costruire un plugin

    Vedi plugins/_template/ per lo scaffold di partenza.

  • Integrare un device

    Wearable, occhiali, display olografici. Vedi agents/.

  • Scrivere test

    Unit, integration, E2E. Obiettivo: 80%+ di copertura.

  • Audit di sicurezza

    Le segnalazioni di sicurezza vanno via email, non in issue pubbliche.

Workflow

  1. Fork del repository
  2. Branch descrittivo (feat/..., fix/..., docs/...)
  3. Commit con Conventional Commits
  4. Push + Pull Request verso main
  5. Code review + merge

Il dettaglio completo è nel file CONTRIBUTING.md.

Regole d'oro

  • File piccoli > file grandi (200–400 righe tipico)
  • Strutture immutabili per default
  • Gestione esplicita degli errori
  • Validazione input ai confini del sistema
  • Mai segreti hardcoded — .env è sempre gitignored
  • Commenti solo quando il perché non è ovvio

Codice di condotta

Il progetto adotta il Contributor Covenant. Comportamenti rispettosi e inclusivi sono attesi da tutti.

Riconoscimento

Ogni contributore viene elencato nel README e nella documentazione. Il tuo lavoro conta.

"Non aspettare il permesso. Apri una PR." — Una verità del software open source