Come contribuire a DataCivicLab

Non serve essere esperti per partecipare. Esistono percorsi diversi a seconda di cosa vuoi fare.

Hai una domanda civica da esplorare

Il punto di ingresso naturale è una Discussion.

Apri una Discussion se vuoi:

  • proporre una domanda su dati pubblici italiani
  • capire se esiste già un filone su un tema che ti interessa
  • contribuire a chiarire una domanda già aperta

Non serve saper programmare. Serve saper formulare bene la domanda e indicare, se la conosci, la fonte pubblica di riferimento.

Quando una Discussion matura e diventa lavoro concreto, si apre una issue nella repo giusta. Il flusso completo è in dataset-project-flow.

Vuoi contribuire a un lavoro in corso

Cerca tra le issue aperte con label good first issue.

Le good first issue sono task leggeri:

  • migliorare docs o guide
  • verificare una fonte
  • aggiungere una nota metodologica
  • sintetizzare una Discussion

Se vuoi invece lavorare su qualcosa di più vicino al flusso tecnico del Lab, guarda le issue con label core-team:

  • review di filone
  • promozione di un candidato da analisi
  • scelta del prossimo output

Vuoi lavorare su un progetto dataset

I progetti attivi sono nella Open Board. Le analisi in corso sono in analisi/.

Per contribuire a un progetto dataset:

  1. leggi il README della repo progetto
  2. guarda le issue aperte nella repo dedicata
  3. se non c’è ancora una repo dedicata, parti dalla Discussion collegata

Per il setup tecnico locale: local-setup.

Vuoi contribuire con codice

Se sai già programmare e vuoi contribuire direttamente a un repo:

  1. Forka il repo su GitHub (tasto Fork in alto a destra)
  2. Clona il tuo fork in locale
  3. Aggiungi l’upstream: git remote add upstream git@github.com:dataciviclab/{repo}.git
  4. Lavora su un branch — mai direttamente su main
  5. Apri una PR dal tuo fork al repo originale

Per il setup tecnico dell’ambiente locale: local-setup.

Come funzionano le decisioni

Il Lab è piccolo e le decisioni si prendono in modo trasparente su GitHub.

  • le Discussion servono a formulare e chiarire la domanda
  • le issue servono a trasformarla in lavoro operativo
  • le PR sono il luogo di review prima di ogni merge

La conversazione può partire ovunque — Discord, LinkedIn, in privato. La traccia utile deve restare su GitHub.

Per capire come funziona la governance del Lab: governance-model.

Per template issue, PR e codice di condotta validi su tutte le repo: .github.