Skip to content
Merged
50 changes: 50 additions & 0 deletions .github/DISCUSSION_TEMPLATE/aggiornamento-analisi.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
title: "[Analisi] Titolo del filone — aggiornamento"
body:
- type: markdown
attributes:
value: |
Usa questo template per pubblicare finding, aggiornamenti o nuovi risultati su un filone gia aperto.

Non serve che il lavoro sia completo: basta che ci sia qualcosa di leggibile da condividere.
Se stai aprendo un filone nuovo, usa invece il template `Dataset` o `Domanda`.

- type: input
id: filone
attributes:
label: Filone di riferimento
description: Slug del filone e link alla Discussion principale, se esiste.
placeholder: irpef-comunale — link discussion
validations:
required: true

- type: textarea
id: finding
attributes:
label: Cosa e emerso
description: Il finding principale in 1-3 frasi. Deve essere leggibile anche da chi non conosce i dati.
placeholder: Scrivi il risultato concreto, con numeri se possibile.
validations:
required: true

- type: textarea
id: limiti
attributes:
label: Cosa non torna o limiti dichiarati
description: Sii esplicito sui caveat. Un finding senza limiti dichiarati e incompleto.
placeholder: Anni mancanti, aggregazione troppo grossa, proxy imperfetto, confrontabilita limitata, ecc.
validations:
required: true

- type: textarea
id: prossima_domanda
attributes:
label: Prossima domanda aperta
description: Cosa vorresti capire meglio dopo questo aggiornamento?
placeholder: La domanda che questo risultato lascia aperta o che andrebbe approfondita.

- type: textarea
id: artefatti
attributes:
label: Artefatti collegati
description: Link a notebook, mart, issue, PR o altri output rilevanti.
placeholder: Link notebook, issue operativa, PR, export, ecc.
2 changes: 1 addition & 1 deletion .github/DISCUSSION_TEMPLATE/datasets.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ body:
Non serve avere già un progetto completo: basta una fonte buona, una possibile domanda e un motivo per cui vale la pena guardarla.

Se la proposta regge, il passo successivo sarà di solito una issue operativa nel repo giusto.
A seconda del caso, il filone potrà passare da `dataset-incubator` per la validazione tecnica oppure entrare direttamente in `dataciviclab/preanalysis`.
A seconda del caso, il filone passerà da `dataset-incubator` per la validazione tecnica e poi in `dataciviclab/analisi/` come layer pubblico.

- type: input
id: fonte
Expand Down
2 changes: 1 addition & 1 deletion .github/DISCUSSION_TEMPLATE/domande.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ body:
value: |
Usa questo template per proporre o chiarire una domanda civica, anche se il dataset non è ancora deciso del tutto.

La Discussion serve a chiarire la domanda. Se la proposta matura, il passo successivo sarà una issue operativa e poi il percorso più adatto del Lab: `dataset-incubator` oppure `dataciviclab/preanalysis`.
La Discussion serve a chiarire la domanda. Se la proposta matura, il passo successivo sarà una issue operativa in `dataset-incubator` e poi il layer pubblico in `dataciviclab/analisi/`.

- type: textarea
id: perche
Expand Down
7 changes: 7 additions & 0 deletions .github/DISCUSSION_TEMPLATE/presentazioni.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,3 +39,10 @@ body:
attributes:
label: Come vorresti contribuire
description: Discussions, analisi, doc, QA, revisione, altro.

- type: textarea
id: primo_passo
attributes:
label: Primo passo concreto
description: C'e qualcosa di specifico che vorresti fare subito? Es. commentare una discussion, prendere un task, proporre una fonte, lavorare su un filone gia aperto.
placeholder: Anche vago va bene — serve a capire come indirizzarti meglio.
2 changes: 1 addition & 1 deletion .github/DISCUSSION_TEMPLATE/proposte.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ body:
id: stato_attuale
attributes:
label: Stato attuale
description: Cosa esiste già? Es. intake, preanalysis privata, notebook v0, output minimo.
description: Cosa esiste già? Es. intake in dataset-incubator, notebook v0, output minimo, layer in analisi/.

- type: dropdown
id: output
Expand Down
3 changes: 1 addition & 2 deletions .github/ISSUE_TEMPLATE/bug.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@
name: 🐛 Bug
about: Segnalazione problema tecnico
title: "[Bug] Descrizione breve"
label: "bug"
type: bug
labels: ["bug"]
---

## 🧾 Problema
Expand Down
2 changes: 1 addition & 1 deletion CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 🌿 Code of Conduct
# Code of Conduct

DataCivicLab vuole essere uno spazio pubblico, rispettoso e utile.

Expand Down
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 🤝 Contributing
# Contributing

Grazie per voler contribuire a DataCivicLab.

Expand All @@ -7,7 +7,7 @@ Questa guida serve a orientarti senza farti studiare tutto prima.
Il Lab e' aperto, ma non caotico.
C'e' un posto giusto per ogni cosa.

## 🌱 Da dove partire
## Da dove partire

Se vuoi capire il quadro generale, parti dalla repository `dataciviclab`.

Expand All @@ -33,7 +33,7 @@ In ogni caso:
Non serve essere esperti del motore per partecipare.
Puoi anche partire da una domanda, da una correzione piccola o da un problema ben descritto.

## 🔄 Flusso minimo
## Flusso minimo

Nell'organizzazione usiamo un flusso semplice:

Expand All @@ -44,7 +44,7 @@ Nell'organizzazione usiamo un flusso semplice:
Le issue servono a rendere il lavoro visibile.
Le pull request servono a far entrare i cambiamenti in modo chiaro e revisionabile.

## 🧩 Cosa usare e quando
## Cosa usare e quando

- `Discussions`: domande, idee, confronto iniziale, orientamento
- `Issues`: lavoro concreto da fare o problema da risolvere
Expand All @@ -57,14 +57,14 @@ GitHub resta il posto dove deve restare la traccia utile.

GitHub Projects puo' essere usato dai maintainer per organizzare il lavoro, ma non sostituisce issue e pull request come traccia pubblica.

## Prima di aprire una PR
## Prima di aprire una PR

- controlla se esiste gia' una issue o discussion collegata
- tieni il cambiamento piccolo e leggibile
- spiega il perche', non solo il cosa
- se la modifica e' specifica di un repo, segui le regole di quel repo

## 🧱 Confini di questa repo
## Confini di questa repo

La repository `.github` definisce il layer comune GitHub dell'organizzazione.
Non descrive il metodo dati, la pipeline tecnica o la struttura operativa dei repository dataset.
Expand Down
34 changes: 0 additions & 34 deletions DISCUSSIONS.md

This file was deleted.

8 changes: 4 additions & 4 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# 🧱 Governance
# Governance

Questo documento riguarda solo la collaborazione cross-repo su GitHub.

## 📘 Cosa decide questa repo
## Cosa decide questa repo

`.github` definisce gli standard condivisi dell'organizzazione per:

Expand All @@ -18,15 +18,15 @@ Non definisce:
- metodo dati
- scelte tecniche del `toolkit`

## 👥 Ruoli pratici
## Ruoli pratici

- `Maintainer`: cura ordine, moderazione, review e coerenza minima tra repository
- `Contributor`: propone, discute e implementa cambiamenti
- `Observer`: legge, segnala, commenta e porta contesto

I ruoli non sono identita' fisse. Contano responsabilita' e contributi concreti.

## 🗂️ Come prendiamo decisioni su GitHub
## Come prendiamo decisioni su GitHub

Quando possibile:

Expand Down
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 🧭 DataCivicLab GitHub Commons
# DataCivicLab GitHub Commons

Questa repository raccoglie i file condivisi che definiscono l'esperienza GitHub comune di `dataciviclab`.

Expand All @@ -12,7 +12,6 @@ Qui vivono:
- template per issue, pull request e discussions
- profilo pubblico dell'organizzazione
- istruzioni minime su supporto, sicurezza e canali
- orientamento leggero su Discussions e Projects pubblici

Qui non vivono:

Expand Down
31 changes: 4 additions & 27 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,7 @@
# 🆘 Support
# Support

Non serve sapere tutto subito.
Serve solo scegliere il canale giusto per quello che ti serve.
Se non sai dove andare, inizia dalle [GitHub Discussions](https://github.com/dataciviclab/dataciviclab/discussions).

## 📍 Dove scrivere
Per vulnerabilita' o contenuti sensibili: [SECURITY.md](SECURITY.md).

- [`GitHub Discussions`](https://github.com/orgs/dataciviclab/discussions): domande, idee, orientamento e confronto pubblico nell'org `dataciviclab`
- `Issues`: bug, problemi chiari, attivita' da svolgere
- `Pull requests`: proposta di modifica gia' pronta
- [`Open Board`](https://github.com/orgs/dataciviclab/projects/5): per vedere il lavoro in corso, i task aperti e i blocchi
- [`Roadmap`](https://github.com/orgs/dataciviclab/projects/2): per vedere direzione pubblica, progetti e milestone
- [`Discord`](https://discord.gg/rAHpuTrYK3): scambio rapido, community ed eventi, ma non fonte canonica
- `LinkedIn`: aggiornamenti pubblici, non supporto operativo

Se hai un dubbio e non sai dove andare, la scelta piu' sicura e' iniziare da GitHub Discussions.

## 📝 Prima di aprire qualcosa

- controlla se esiste gia' una issue o discussion simile
- scegli il repository corretto
- se ti serve solo orientamento, parti dalle Discussions dell'organizzazione
- se vuoi capire cosa si sta facendo adesso, guarda `Open Board`
- se vuoi capire dove stiamo andando, guarda `Roadmap`
- se il tema riguarda metodo dati o implementazione tecnica, usa il repository dedicato

## 🔐 Sicurezza e comportamento

- per vulnerabilita' o contenuti sensibili, vedi [SECURITY.md](SECURITY.md)
- per problemi di comportamento o moderazione, contatta i maintainer del repository coinvolto
Per problemi di comportamento o moderazione, contatta in privato i maintainer del repository coinvolto.
61 changes: 40 additions & 21 deletions profile/README.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,51 @@
# 🌍 DataCivicLab
# DataCivicLab

DataCivicLab e' uno spazio civico dove proviamo a rendere i dati pubblici piu' leggibili, utili e condivisibili.
DataCivicLab è uno spazio civico dove proviamo a rendere i dati pubblici più leggibili, utili e condivisibili.

Non serve capire tutto subito.
Serve solo capire da dove iniziare.
Nasce per chi vuole capire meglio il proprio territorio senza perdersi nel rumore, nei tecnicismi o nelle opinioni gridate.

## 🌱 Dove iniziare
## Come funziona

- [`dataciviclab`](https://github.com/dataciviclab/dataciviclab): hub pubblico e umano dell'organizzazione
- [`toolkit`](https://github.com/dataciviclab/toolkit): motore tecnico della pipeline dati
- [`project-template`](https://github.com/dataciviclab/project-template): base operativa dei repository dataset
Il percorso è sempre lo stesso: domanda civica, dati pubblici verificabili, metodo documentato, output leggibile.

## 🤝 Come partecipare
Ogni progetto parte da una domanda che chiunque può capire.
Il risultato è pubblico e accessibile anche a chi non lavora con i dati.

- [GitHub Discussions](https://github.com/orgs/dataciviclab/discussions): per fare domande, proporre idee e parlare con calma lasciando traccia
- `Issues`: per il lavoro concreto da fare
- `Pull requests`: per proporre modifiche
## Cosa abbiamo pubblicato

Se non sai ancora dove stare, parti dalle Discussions dell'organizzazione.
**Rifiuti urbani nei comuni italiani**
In molti comuni la percentuale di raccolta differenziata cresce, ma crescono anche i rifiuti totali prodotti: l'indicatore da solo non basta a valutare la performance ambientale.
Fonte: ISPRA. [Dashboard interattiva](https://app.powerbi.com/view?r=eyJrIjoiZmE5MTNlZmItN2NkZC00ZTkyLWEwZGItMzE3ZWJkNzI0ZjZjIiwidCI6IjgwNjZmMmRlLTgxZDctNGVjNC04Y2E5LTgzNzVjOTA4NjViNSJ9) · [repo](https://github.com/dataciviclab/progetto-pilota)

## 🔗 Canali
**Bilancio dello Stato 2003-2024**
Dal 2003 al 2024 la spesa corrente ha assorbito in media il 64% del bilancio statale. La spesa in conto capitale ha toccato il minimo del 4,9% nel 2015. L'avanzo primario è stato positivo in 16 anni su 22, azzerato ogni volta dagli interessi sul debito.
Fonte: OpenBDAP/RGS. [Discussioni con risposta dati](https://github.com/dataciviclab/openbdap-saldi-storico-stato/discussions) · [repo](https://github.com/dataciviclab/openbdap-saldi-storico-stato)

- [GitHub Discussions](https://github.com/orgs/dataciviclab/discussions): confronto pubblico e asincrono
- [Open Board](https://github.com/orgs/dataciviclab/projects/5): lavoro in corso, task, blocchi e attivita' operative
- [Roadmap](https://github.com/orgs/dataciviclab/projects/2): direzione pubblica, progetti e milestone
- [Discord](https://discord.gg/rAHpuTrYK3): scambio veloce ed eventi, ma non fonte canonica
- LinkedIn: aggiornamenti pubblici e visibilita' esterna
## Cosa stiamo analizzando

GitHub resta il posto dove deve restare la traccia utile.
- Come varia la capacità fiscale IRPEF tra comuni e regioni? (MEF, 2019-2023)
- Le regioni con meno personale sanitario hanno tassi di mortalità evitabile più alti? (2022)
- Il mix elettrico italiano si sta spostando dalle fonti fossili? (Terna, 2020-2024)
- Il carico della giustizia civile sta migliorando nei territori? (Ministero della Giustizia, 2014-2024)
- Come cambia il pubblico impiego per comparto? (BDAP, 2021-2023)

Per contribuire, parti dal canale o dal repository piu' vicino a quello che vuoi capire o migliorare.
Tutte le analisi in corso: [dataciviclab/analisi](https://github.com/dataciviclab/dataciviclab/tree/main/analisi)

## Come iniziare

**Hai una domanda su un tema civico** (sanita, giustizia, finanza pubblica, ambiente)?
Apri una [Discussion](https://github.com/dataciviclab/dataciviclab/discussions/new) con la tua domanda. Non serve saper programmare.

**Conosci bene un settore** (sei un operatore, un ricercatore, un giornalista)?
Commenta una delle [analisi in corso](https://github.com/dataciviclab/dataciviclab/discussions): i caveat e il contesto di dominio valgono quanto il codice.

**Sai lavorare con i dati** (Python, SQL, notebook)?
Guarda le [issue con buon punto di ingresso](https://github.com/dataciviclab/dataciviclab/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) o l'[Open Board](https://github.com/orgs/dataciviclab/projects/5) per vedere il lavoro in corso.

## Canali

- [Discussions](https://github.com/dataciviclab/dataciviclab/discussions): proposte, domande, confronto pubblico
- [Discord](https://discord.gg/rAHpuTrYK3): scambio veloce e community
- [LinkedIn](https://www.linkedin.com/company/dataciviclab/): aggiornamenti pubblici

La traccia delle decisioni resta su GitHub.
Loading