diff --git a/.github/DISCUSSION_TEMPLATE/aggiornamento-analisi.yml b/.github/DISCUSSION_TEMPLATE/aggiornamento-analisi.yml new file mode 100644 index 0000000..0a1fb87 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/aggiornamento-analisi.yml @@ -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. diff --git a/.github/DISCUSSION_TEMPLATE/datasets.yml b/.github/DISCUSSION_TEMPLATE/datasets.yml index 3253f4e..7aa44fc 100644 --- a/.github/DISCUSSION_TEMPLATE/datasets.yml +++ b/.github/DISCUSSION_TEMPLATE/datasets.yml @@ -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 diff --git a/.github/DISCUSSION_TEMPLATE/domande.yml b/.github/DISCUSSION_TEMPLATE/domande.yml index eedb697..441186d 100644 --- a/.github/DISCUSSION_TEMPLATE/domande.yml +++ b/.github/DISCUSSION_TEMPLATE/domande.yml @@ -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 diff --git a/.github/DISCUSSION_TEMPLATE/presentazioni.yml b/.github/DISCUSSION_TEMPLATE/presentazioni.yml index a572aa2..ca823b1 100644 --- a/.github/DISCUSSION_TEMPLATE/presentazioni.yml +++ b/.github/DISCUSSION_TEMPLATE/presentazioni.yml @@ -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. diff --git a/.github/DISCUSSION_TEMPLATE/proposte.yml b/.github/DISCUSSION_TEMPLATE/proposte.yml index 1ba955f..ae24528 100644 --- a/.github/DISCUSSION_TEMPLATE/proposte.yml +++ b/.github/DISCUSSION_TEMPLATE/proposte.yml @@ -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 diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md index 20ccc58..68031be 100644 --- a/.github/ISSUE_TEMPLATE/bug.md +++ b/.github/ISSUE_TEMPLATE/bug.md @@ -2,8 +2,7 @@ name: 🐛 Bug about: Segnalazione problema tecnico title: "[Bug] Descrizione breve" -label: "bug" -type: bug +labels: ["bug"] --- ## 🧾 Problema diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 9add795..30ee1c9 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,4 +1,4 @@ -# 🌿 Code of Conduct +# Code of Conduct DataCivicLab vuole essere uno spazio pubblico, rispettoso e utile. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 39e291c..2054fe1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,4 @@ -# 🤝 Contributing +# Contributing Grazie per voler contribuire a DataCivicLab. @@ -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`. @@ -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: @@ -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 @@ -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. diff --git a/DISCUSSIONS.md b/DISCUSSIONS.md deleted file mode 100644 index b5c6278..0000000 --- a/DISCUSSIONS.md +++ /dev/null @@ -1,34 +0,0 @@ -# 💬 Discussions e Projects - -Le GitHub Discussions sono il posto giusto quando serve parlare prima di implementare. -Sono il posto giusto anche quando non hai ancora capito tutto ma vuoi lasciare una traccia chiara. - -Usale per: - -- fare una domanda -- proporre un'idea -- chiedere orientamento sul repository giusto -- aprire un confronto pubblico prima di trasformarlo in issue - -Non usarle per: - -- segnalare vulnerabilita' -- sostituire una pull request -- tenere nascosto lavoro operativo che dovrebbe stare in una issue - -Se da una discussion emerge un lavoro concreto, apri o collega una issue. - -## 📌 Projects pubblici - -In DataCivicLab usiamo due GitHub Projects pubblici: - -- [`Open Board`](https://github.com/orgs/dataciviclab/projects/5): lavoro in corso, task, issue, blocchi e attivita' operative -- [`Roadmap`](https://github.com/orgs/dataciviclab/projects/2): direzione pubblica, progetti, milestone e prossime tappe - -Usali per orientarti, non per sostituire issue e pull request. - -- se vuoi capire cosa sta succedendo adesso, guarda `Open Board` -- se vuoi capire dove stiamo andando, guarda `Roadmap` -- se vuoi parlare con calma e lasciare traccia, usa `Discussions` - -Discord e' utile per scambio veloce o eventi, ma la traccia utile deve restare su GitHub. diff --git a/GOVERNANCE.md b/GOVERNANCE.md index 1ccf917..d623727 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -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: @@ -18,7 +18,7 @@ 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 @@ -26,7 +26,7 @@ Non definisce: I ruoli non sono identita' fisse. Contano responsabilita' e contributi concreti. -## 🗂️ Come prendiamo decisioni su GitHub +## Come prendiamo decisioni su GitHub Quando possibile: diff --git a/README.md b/README.md index 7df41de..a39eb96 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# 🧭 DataCivicLab GitHub Commons +# DataCivicLab GitHub Commons Questa repository raccoglie i file condivisi che definiscono l'esperienza GitHub comune di `dataciviclab`. @@ -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: diff --git a/SUPPORT.md b/SUPPORT.md index 706cbc8..2aa5343 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -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. diff --git a/profile/README.md b/profile/README.md index fd40e3d..1cc80ef 100644 --- a/profile/README.md +++ b/profile/README.md @@ -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.