Pubblicare software per la PA

La scelta della licenza è necessaria per poter pubblicare un software secondo le Linee Guida dell’Agenzia per l’Italia Digitale su acquisizione e riuso del software nella PA.

• Preferenza per licenze open source (OSI) e Free Software riconosciute, per la PA si consiglia la EUPL, riconosciuta e validata a livello EU
• L’ente deve motivare eventuali eccezioni qualora non fosse possibile pubblicare il software come open source

Oltre al codice, anche i metadati devono essere rilasciabili e riutilizzabili.

• I metadati sono generalmente pubblicati con licenze aperte e permissive, come CC BY 4.0 o CC0
• Devono descrivere chiaramente: nome del progetto, versione, ambito funzionale, amministrazione titolare, tecnologie usate, requisiti, documentazione e contatti
• La qualità dei metadati è essenziale per rendere il software trovabile e indicizzabile nei cataloghi dedicati

Prima della pubblicazione è necessario organizzare il materiale in modo strutturato e conforme alle linee guida:

• Scegliere un sistema di code hosting o un servizio di code hosting
• Registrare l’amministrazione sul portale Developers Italia
• Pubblicare il software seguendo le linee guida, tra cui ricordiamo:
  1. file LICENSE con la licenza scelta
  2. file README con spiegazione chiara della soluzione, prerequisiti e modalità di installazione
  3. eventuale documentazione tecnica
  4. istruzioni per il deploy e per contribuire al progetto (CONTRIBUTING.md, se previsto)
  5. changelog per tracciare le modifiche

Prima della pubblicazione è raccomandato eseguire:

• scansioni di sicurezza (static code analysis, dependency checks);
• controlli sulle vulnerabilità note
• revisione tecnica del codice e della documentazione.

Questi passaggi aiutano a garantire che il software pubblicato sia affidabile, manutenibile e conforme agli standard di sicurezza della PA.

Per rendere il software ricercabile dalle altre PA è necessario compilare correttamente la scheda informativa che è codificata nel formato pubbliccode.yml con:

• titolo del software
• descrizione funzionale
• link al repository
• licenza
• contatto dell’amministrazione titolare
• categoria e parole chiave
• stato di manutenzione (attivo, in evoluzione, deprecated).

Una scheda chiara e completa facilita il riuso e rende il software più attrattivo.

Una volta pronto il repository, il passo successivo è la pubblicazione nei canali previsti:

• Developers Italia – Catalogo del Software a Riuso. È il principale punto di riferimento nazionale. Permette ad altre PA di trovare, valutare e riutilizzare il software. La pubblicazione richiede il rispetto delle linee guida AgID e la presenza di un repository ben strutturato.

• Cataloghi e portali tematici. Se il software rientra in particolari ecosistemi (es. API, interoperabilità, design system), può essere pubblicato anche nei loro cataloghi di riferimento.

La pubblicazione non è il punto di arrivo, ma l’inizio del ciclo di vita pubblico della soluzion.

• Aggiornare regolarmente repository e metadati
• Registrare nuove versioni
• Rispondere ai contributi o alle segnalazioni (issue/pull request)
• Mantenere trasparenza sullo stato evolutivo del progetto