From fa71f547037e65f05b497df8b22b186338fb0d93 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 13:28:01 +0000 Subject: [PATCH 01/14] refactor org-wide community docs --- CODE_OF_CONDUCT.md | 24 ++++--- CONTRIBUTING.md | 132 +++++++++------------------------------ DISCUSSIONS.md | 18 ++++++ GOVERNANCE.md | 43 ++++++++----- PULL_REQUEST_TEMPLATE.md | 43 +++++-------- README.md | 37 +++++------ SECURITY.md | 24 ++++--- SUPPORT.md | 22 +++++++ WORKFLOW.md | 70 --------------------- profile/README.md | 49 +++++---------- 10 files changed, 174 insertions(+), 288 deletions(-) create mode 100644 DISCUSSIONS.md create mode 100644 SUPPORT.md delete mode 100644 WORKFLOW.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 2ba81cb..30ee1c9 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,15 +1,21 @@ # Code of Conduct -Il DataCivicLab è uno spazio collaborativo e rispettoso. +DataCivicLab vuole essere uno spazio pubblico, rispettoso e utile. Ci aspettiamo: -- rispetto reciproco -- confronto basato su fatti e dati -- zero attacchi personali -Comportamenti inaccettabili: -- molestie -- discriminazioni -- trolling +- rispetto per le persone e per il loro tempo +- critiche rivolte alle idee, non alle persone +- confronto chiaro, documentato e in buona fede +- attenzione a linguaggio, contesto e accessibilita' -I maintainer possono intervenire per tutelare la community. +Non sono accettati: + +- insulti, attacchi personali o intimidazioni +- discriminazioni o molestie +- comportamenti deliberatamente ostili o distruttivi +- pubblicazione di dati personali, credenziali o informazioni sensibili + +I maintainer possono moderare discussioni, chiudere thread o limitare la partecipazione quando serve a proteggere la qualita' dello spazio comune. + +Per segnalare un problema di comportamento, usa i riferimenti indicati in [SUPPORT.md](SUPPORT.md). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a1bff89..25d7d78 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,120 +1,48 @@ -# 🤝 Come contribuire al DataCivicLab +# Contributing -Questo è un progetto civico aperto. -Puoi contribuire anche senza far parte dell’organizzazione. +Grazie per voler contribuire a DataCivicLab. -## 🧭 1) Guardare e capire (senza fare nulla) +Questa guida spiega come entrare in modo semplice nei repository dell'organizzazione senza duplicare la documentazione specifica dei singoli progetti. -Puoi: +## Da dove partire -* leggere i repository pubblici -* guardare gli output (dashboard, report) -* capire **come lavoriamo davvero** +Se vuoi capire il contesto generale, parti dalla repository `dataciviclab`. -👉 Non serve iscriversi. -👉 Non serve essere “esperti”. +Se vuoi contribuire a un repository specifico: -Questo è già contributo: **trasparenza**. +- leggi il suo `README.md` +- controlla issue e discussions aperte +- verifica se esistono istruzioni locali aggiuntive +## Flusso minimo -## 💡 2) Proporre un problema o una domanda civica +Nell'organizzazione usiamo un flusso semplice: -Puoi: +1. apri o trovi una Discussion se serve chiarire il contesto +2. apri o prendi in carico una Issue quando il lavoro e' definito +3. proponi il cambiamento con una Pull Request -* aprire una **Discussion** -* proporre una **domanda concreta** -* segnalare un **dataset pubblico** +Le issue servono a rendere il lavoro visibile. +Le pull request servono a far entrare i cambiamenti in modo chiaro e revisionabile. -Esempio: +## Cosa usare e quando -> “Esiste un modo per capire come vengono spesi questi fondi?” +- `Discussions`: domande, idee, confronto iniziale, orientamento +- `Issues`: lavoro concreto da fare o problema da risolvere +- `Pull requests`: proposta di modifica pronta da rivedere -Non serve la soluzione. -Serve una **buona domanda**. +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 -## 📊 3) Segnalare o mappare dataset pubblici +- 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 -Se conosci: +## Confini di questa repo -* una banca dati pubblica -* un open data poco usato -* una fonte istituzionale utile - -Puoi: - -* segnalarla in Discussion -* indicare link, periodo, ente - -👉 Questo spesso è il **vero punto di partenza**. - - -## 🛠️ 4) Migliorare qualcosa che già esiste - -Se vedi: - -* un errore -* un limite -* una spiegazione poco chiara - -Puoi: - -* aprire una **Issue** -* oppure una **Pull Request** (anche piccola) - -Non serve rifare tutto. -Anche migliorare una frase, un grafico o una query è contributo. - - -## 🔍 5) Fare revisione e QA - -Anche senza scrivere codice puoi: - -* verificare se i numeri tornano -* controllare se il metodo è chiaro -* segnalare ambiguità - -👉 Il **controllo civico** è anche questo. - - -## 📣 6) Usare e diffondere gli output - -Puoi: - -* usare una dashboard -* citarla in un articolo -* condividerla con altri -* usarla per fare domande a un’amministrazione - -Questo è **impatto reale**, non marketing. - - -## 🚀 7) Entrare in un progetto (se vuoi) - -Se vuoi contribuire attivamente: - -* guardi le **Issue aperte** -* scegli un task chiaro -* ti assegni o commenti - -Non serve “essere dentro”. -Conta **quello che fai**, non il badge. - - -# 🧠 Regole semplici (per tutti) - -* Nessuno è obbligato a fare nulla -* Nessuno decide da solo -* Le idee diventano realtà solo se producono output -* Tutto è pubblico e verificabile - - -# 🧩 In una frase - -> Puoi osservare, proporre, migliorare, verificare o usare. -> Se qualcosa ti sembra utile o sbagliato, puoi dirlo e mostrarlo. - -Questo è il DataCivicLab. - -Prima di iniziare, leggi il [WORKFLOW.md](WORKFLOW.md). +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. +Per quei contenuti, fai riferimento ai repository dedicati. diff --git a/DISCUSSIONS.md b/DISCUSSIONS.md new file mode 100644 index 0000000..783a9a5 --- /dev/null +++ b/DISCUSSIONS.md @@ -0,0 +1,18 @@ +# Discussions + +Le GitHub Discussions sono il posto giusto quando serve parlare prima di implementare. + +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. diff --git a/GOVERNANCE.md b/GOVERNANCE.md index ba334a8..b3c3281 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -1,22 +1,37 @@ -# ⚖️ Governance DataCivicLab +# Governance -Questo è un progetto civico e uno spazio comune. -Non c’è un capo e nulla è definitivo. +Questo documento riguarda solo la collaborazione cross-repo su GitHub. -Il metodo e il sistema si costruiscono attraverso: -- contributi concreti -- output pubblici -- miglioramenti incrementali +## Cosa decide questa repo -Chi contribuisce se ne prende cura. -Le decisioni seguono il metodo, non le opinioni. +`.github` definisce gli standard condivisi dell'organizzazione per: -Nel DataCivicLab usiamo GitHub Teams solo per gestire permessi tecnici. +- onboarding contributor +- template e flussi GitHub comuni +- regole minime di collaborazione pubblica +- supporto, moderazione e sicurezza -- I maintainer sono custodi del metodo e dell’ordine minimo, non capi. +Non definisce: -- I contributor producono lavoro e output. +- roadmap del Lab +- priorita' di prodotto o di ricerca +- metodo dati +- scelte tecniche del `toolkit` -- Gli observer osservano e imparano. +## Ruoli pratici -I ruoli non sono fissi e possono cambiare nel tempo, in base ai contributi reali. +- `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 + +Quando possibile: + +1. il confronto parte in una Discussion o in una issue +2. il cambiamento viene proposto in modo tracciabile +3. la decisione finale viene resa visibile nella pull request o nell'issue collegata + +Se una decisione riguarda un solo repository, vale la documentazione di quel repository. diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md index 53d3d26..a40ff49 100644 --- a/PULL_REQUEST_TEMPLATE.md +++ b/PULL_REQUEST_TEMPLATE.md @@ -1,36 +1,21 @@ -# 🧾 Pull Request – DataCivicLab +## Summary -## 🔗 Issue collegata -Closes # +Spiega in poche righe cosa cambia e perche'. -## 🎯 Contesto -Spiega brevemente perché questa PR è necessaria. +## Linked context -## ⚙️ Cosa cambia -Descrivi in modo sintetico le modifiche introdotte: -- punto 1 -- punto 2 -- punto 3 +Closes # -## 📊 Impatto su dati / metodo / dashboard -Indicare se questa PR impatta: -- [ ] RAW -- [ ] CLEAN -- [ ] MART -- [ ] Dashboard -- [ ] Metodo -- [ ] Documentazione -- [ ] Bugfix -- [ ] Nessun impatto dati +## Type of change -Spiega eventuali effetti su replicabilità o confrontabilità. +- [ ] Documentation or copy update +- [ ] Policy or template update +- [ ] Community health update +- [ ] Repository-specific change -## 🧪 QA Checklist -- [ ] Ho testato il codice / notebook -- [ ] Non rompe pipeline esistenti -- [ ] Naming coerente (snake_case, convenzioni Lab) -- [ ] Documentazione aggiornata -- [ ] Ho collegato l’issue corretta +## Checks -## 📝 Note per i reviewer -Segnala punti critici o aspetti che richiedono particolare attenzione \ No newline at end of file +- [ ] Ho verificato che questa PR sia nel repository giusto +- [ ] Ho collegato issue o discussion quando serve +- [ ] Ho mantenuto il cambiamento piccolo e leggibile +- [ ] Ho aggiornato la documentazione solo dove serve davvero diff --git a/README.md b/README.md index 742cef5..d6653d1 100644 --- a/README.md +++ b/README.md @@ -1,28 +1,21 @@ -# DataCivicLab – Governance & Workflow +# DataCivicLab GitHub Commons -Questo repository definisce le **regole operative comuni** a tutti i progetti del DataCivicLab. +Questa repository raccoglie i file condivisi che definiscono l'esperienza GitHub comune di `dataciviclab`. -Qui non ci sono dati, codice o dashboard. -Qui ci sono: -- come lavoriamo -- come contribuiamo -- come prendiamo decisioni -- come manteniamo qualità e coerenza +Qui vivono: -## 📌 File principali -- `WORKFLOW.md` → come funziona il lavoro quotidiano -- `CONTRIBUTING.md` → come iniziare a contribuire -- `ISSUE_TEMPLATE/` → come aprire Issue utili -- `PULL_REQUEST_TEMPLATE.md` → come proporre cambiamenti -- `CODE_OF_CONDUCT.md` → regole di comportamento -- `SECURITY.md` → gestione segnalazioni sensibili +- community health files +- policy comuni di collaborazione +- template per issue, pull request e discussions +- profilo pubblico dell'organizzazione +- istruzioni minime su supporto, sicurezza e canali -## 🧭 Regola base -> Se una regola vale per più di un progetto, vive qui. +Qui non vivono: -Per regole specifiche di un progetto, fai riferimento al repository dedicato. +- cataloghi dataset +- roadmap del Lab +- metodo dati +- documentazione tecnica del toolkit +- bootstrap operativo dei repository dataset -## 📘 Regole operative - -- [Workflow di lavoro](WORKFLOW.md) -- [Come contribuire](CONTRIBUTING.md) +Per il contesto generale del Lab e l'indice dell'ecosistema, il punto di ingresso resta la repository `dataciviclab`. diff --git a/SECURITY.md b/SECURITY.md index ab3e95b..af45af4 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -1,12 +1,18 @@ -# Security Policy +# Security -Non pubblicare: -- dati personali non anonimizzati -- credenziali -- informazioni sensibili +Se trovi una vulnerabilita', non aprire una issue pubblica. + +Usa GitHub Security Advisories se disponibili per il repository coinvolto. Se non sono disponibili, contatta i maintainer in modo riservato prima di pubblicare dettagli. + +Usa i canali pubblici solo per: -Per segnalazioni di sicurezza: -- aprire una Issue privata se possibile -- oppure contattare i maintainer +- domande generali di sicurezza +- chiarimenti non sensibili +- miglioramenti di documentazione -Grazie per aiutarci a mantenere il Lab sicuro. +Non pubblicare mai: + +- credenziali +- token +- dati personali +- dettagli che facilitano uno sfruttamento immediato del problema diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 0000000..3a4f4bc --- /dev/null +++ b/SUPPORT.md @@ -0,0 +1,22 @@ +# Support + +Usa il canale giusto in base a quello che ti serve. + +## Dove scrivere + +- `GitHub Discussions`: domande, idee, orientamento, confronto pubblico +- `Issues`: bug, problemi chiari, attivita' da svolgere +- `Pull requests`: proposta di modifica gia' pronta +- `Discord`: scambio rapido e informale tra persone della community +- `LinkedIn`: aggiornamenti pubblici, non supporto operativo + +## Prima di aprire qualcosa + +- controlla se esiste gia' una issue o discussion simile +- scegli il repository corretto +- 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 diff --git a/WORKFLOW.md b/WORKFLOW.md deleted file mode 100644 index ced4b23..0000000 --- a/WORKFLOW.md +++ /dev/null @@ -1,70 +0,0 @@ -# DataCivicLab – Workflow operativo - -Flusso ufficiale: -**Discussion → Issue → Branch → Pull Request → Merge** - ---- - -## 1. Discussions -Usate per: -- chiarire la domanda civica -- discutere dataset, limiti, metodo -- allinearci prima di lavorare - -Se non è chiaro **cosa fare**, apri una Discussion. - ---- - -## 2. Issues -Ogni lavoro nasce come Issue. - -Regole: -- una Issue = un obiettivo chiaro -- Issue piccole > Issue grandi -- se lavori su una Issue, assegnatela - ---- - -## 3. Branch -Non si lavora mai su `main`. - -Regola: -> **1 Issue = 1 Branch** - -Naming consigliato: -- `feature/...` -- `fix/...` -- `docs/...` - ---- - -## 4. Pull Request -Tutto passa da PR. - -Ogni PR: -- collega una Issue (`Closes #ID`) -- descrive cosa fa -- passa almeno una review - ---- - -## 5. Review & Merge -- 1 approvazione minima -- commenti risolti -- merge su `main` -- branch eliminato - ---- - -## 6. Ruoli -- **Observer**: legge e commenta -- **Contributor**: lavora su Issue e PR -- **Maintainer**: review, merge, qualità -- **Project Lead**: visione e decisioni finali - ---- - -## Regole d’oro -- Se non è una Issue, non esiste -- Se non è una PR, non entra in `main` -- Meglio PR piccole che PR mostro diff --git a/profile/README.md b/profile/README.md index 1643d20..9cd6007 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,41 +1,24 @@ -# 🌍 DataCivicLab +# DataCivicLab -Un laboratorio open che trasforma dati pubblici in comprensione civica strutturata. +DataCivicLab e' un laboratorio civico che usa dati pubblici, strumenti aperti e collaborazione trasparente per produrre comprensione condivisa. -Non produciamo opinioni. -Produciamo metodo. +## Dove iniziare -## 🧠 Cosa facciamo +- `dataciviclab`: hub pubblico e indice dell'organizzazione +- `toolkit`: motore della pipeline dati +- `project-template`: base operativa dei repository dataset -- Analizziamo dataset pubblici ufficiali -- Costruiamo pipeline replicabili -- Standardizziamo trasformazioni dati -- Pubbliciamo dashboard verificabili -- Documentiamo ogni scelta metodologica +## Come partecipare -## ⚙️ Come lavoriamo +- `Discussions` per domande, idee e confronto iniziale +- `Issues` per lavoro concreto da fare +- `Pull requests` per proporre modifiche -Domanda → Dataset → Pipeline → Analisi → Dashboard +## Canali -Ogni progetto è documentato e versionato. +- GitHub Discussions: confronto pubblico e asincrono +- GitHub Projects: coordinamento operativo dei maintainer +- Discord: confronto informale e community +- LinkedIn: aggiornamenti pubblici e visibilita' esterna -## 🏗 Repo principali - -- `dataciviclab` → Governance e roadmap -- `project-template` → Struttura replicabile -- `toolkit` → Strumenti per pipeline dati (WIP) - -## 🚀 Vuoi contribuire? - -Cerchiamo: - -- Data nerd -- Analisti civici -- Sviluppatori -- Curiosi strutturati - -👉 [Esplora le Discussions](https://github.com/orgs/dataciviclab/discussions) -👉 [Leggi il Manifesto](https://github.com/dataciviclab/dataciviclab/blob/main/docs/manifesto.md) -👉 [Unisciti alla community](https://discord.gg/rAHpuTrYK3) - -Costruiamo infrastruttura civica, non solo dashboard. +Per contribuire, parti dalle discussions o dal repository piu' vicino al tema su cui vuoi lavorare. From 3b2da5b7b92078cea87b60d52c6471aff375d982 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 13:28:14 +0000 Subject: [PATCH 02/14] streamline org issue and discussion templates --- .github/DISCUSSION_TEMPLATE/datasets.yml | 28 --------- .github/DISCUSSION_TEMPLATE/domande.yml | 16 ------ .github/DISCUSSION_TEMPLATE/idea.yml | 28 +++++++++ .github/DISCUSSION_TEMPLATE/introduction.yml | 23 ++++++++ .github/DISCUSSION_TEMPLATE/metodo.yml | 27 --------- .github/DISCUSSION_TEMPLATE/presentazioni.yml | 40 ------------- .github/DISCUSSION_TEMPLATE/proposte.yml | 57 ------------------- .github/DISCUSSION_TEMPLATE/question.yml | 23 ++++++++ .github/ISSUE_TEMPLATE/bug.md | 21 ------- .github/ISSUE_TEMPLATE/bug_report.yml | 39 +++++++++++++ .github/ISSUE_TEMPLATE/change_request.yml | 38 +++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 14 +++-- .github/ISSUE_TEMPLATE/task.md | 20 ------- 13 files changed, 161 insertions(+), 213 deletions(-) delete mode 100644 .github/DISCUSSION_TEMPLATE/datasets.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/domande.yml create mode 100644 .github/DISCUSSION_TEMPLATE/idea.yml create mode 100644 .github/DISCUSSION_TEMPLATE/introduction.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/metodo.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/presentazioni.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/proposte.yml create mode 100644 .github/DISCUSSION_TEMPLATE/question.yml delete mode 100644 .github/ISSUE_TEMPLATE/bug.md create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/change_request.yml delete mode 100644 .github/ISSUE_TEMPLATE/task.md diff --git a/.github/DISCUSSION_TEMPLATE/datasets.yml b/.github/DISCUSSION_TEMPLATE/datasets.yml deleted file mode 100644 index 257e977..0000000 --- a/.github/DISCUSSION_TEMPLATE/datasets.yml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Dataset] Nome dataset" -body: - - type: markdown - attributes: - value: | - Usa questo template per discutere una nuova fonte dati prima di aprire una Issue operativa. - - - type: input - id: fonte - attributes: - label: 🔗 Fonte ufficiale - placeholder: URL dataset - - - type: textarea - id: descrizione - attributes: - label: 🧾 Cosa contiene? - description: Descrizione sintetica del dataset - - - type: textarea - id: struttura - attributes: - label: 🏗 Struttura dati - - - type: textarea - id: criticita - attributes: - label: ⚠ Limiti o rischi diff --git a/.github/DISCUSSION_TEMPLATE/domande.yml b/.github/DISCUSSION_TEMPLATE/domande.yml deleted file mode 100644 index 46931b8..0000000 --- a/.github/DISCUSSION_TEMPLATE/domande.yml +++ /dev/null @@ -1,16 +0,0 @@ -title: "[Domanda] Quesito analitico" -body: - - type: textarea - id: perche - attributes: - label: 🎯 Perché questa domanda è rilevante? - - - type: textarea - id: metriche - attributes: - label: 📏 Metriche possibili - - - type: textarea - id: ipotesi - attributes: - label: 🧠 Ipotesi iniziali diff --git a/.github/DISCUSSION_TEMPLATE/idea.yml b/.github/DISCUSSION_TEMPLATE/idea.yml new file mode 100644 index 0000000..083050b --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/idea.yml @@ -0,0 +1,28 @@ +title: "[Idea] " +body: + - type: markdown + attributes: + value: | + Usa questo template per proporre un'idea prima di aprire una issue operativa. + - type: textarea + id: idea + attributes: + label: Idea + description: Descrivi la proposta in modo semplice + validations: + required: true + - type: textarea + id: why + attributes: + label: Perche' potrebbe essere utile + description: Quale bisogno o opportunita' vedi + - type: input + id: repo + attributes: + label: Repository coinvolto + placeholder: Se lo sai gia' + - type: textarea + id: next + attributes: + label: Prossimo passo possibile + description: Cosa servirebbe per trasformarla in issue diff --git a/.github/DISCUSSION_TEMPLATE/introduction.yml b/.github/DISCUSSION_TEMPLATE/introduction.yml new file mode 100644 index 0000000..6000d2a --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/introduction.yml @@ -0,0 +1,23 @@ +title: "[Intro] " +body: + - type: markdown + attributes: + value: | + Usa questo template per presentarti alla community e dire da dove vuoi iniziare. + - type: textarea + id: who + attributes: + label: Chi sei + description: Una breve presentazione + validations: + required: true + - type: textarea + id: interests + attributes: + label: Cosa ti interessa + description: Temi, repository o tipi di contributo che ti attirano + - type: textarea + id: help + attributes: + label: Come possiamo orientarti + description: Se hai gia' una domanda o un primo passo in mente diff --git a/.github/DISCUSSION_TEMPLATE/metodo.yml b/.github/DISCUSSION_TEMPLATE/metodo.yml deleted file mode 100644 index eff980e..0000000 --- a/.github/DISCUSSION_TEMPLATE/metodo.yml +++ /dev/null @@ -1,27 +0,0 @@ -title: "[Metodo] Scelta metodologica" -body: - - type: markdown - attributes: - value: | - Usa questo template per discutere scelte metodologiche prima di implementarle. - - - type: textarea - id: contesto - attributes: - label: 🧩 Contesto - required: true - - - type: textarea - id: scelta - attributes: - label: ⚙ Proposta metodologica - - - type: textarea - id: alternative - attributes: - label: 🔄 Alternative valutate - - - type: textarea - id: impatto - attributes: - label: 📊 Impatto su replicabilità e confronto diff --git a/.github/DISCUSSION_TEMPLATE/presentazioni.yml b/.github/DISCUSSION_TEMPLATE/presentazioni.yml deleted file mode 100644 index a9ce629..0000000 --- a/.github/DISCUSSION_TEMPLATE/presentazioni.yml +++ /dev/null @@ -1,40 +0,0 @@ -title: "[Presentazione] Nome o nickname" -body: - - type: markdown - attributes: - value: | - Usa questo template per presentarti alla community DataCivicLab. - - - type: textarea - id: bio - attributes: - label: 👤 Chi sei - description: Breve bio (2–3 righe). - validations: - required: true - - - type: textarea - id: competenze - attributes: - label: 🧠 Competenze - description: Dati, analisi, visualizzazione, metodo, altro. - - - type: textarea - id: interessi - attributes: - label: 💡 Cosa ti interessa - description: Temi civici, dataset, progetti. - - - type: dropdown - id: disponibilita - attributes: - label: ⏱️ Disponibilità - options: - - Occasionale - - Continuativa - - - type: textarea - id: contributo - attributes: - label: 🤝 Come vorresti contribuire - description: Discussioni, analisi, doc, QA, altro. \ No newline at end of file diff --git a/.github/DISCUSSION_TEMPLATE/proposte.yml b/.github/DISCUSSION_TEMPLATE/proposte.yml deleted file mode 100644 index 4edebb7..0000000 --- a/.github/DISCUSSION_TEMPLATE/proposte.yml +++ /dev/null @@ -1,57 +0,0 @@ -title: "[Progetto] Titolo del progetto" -body: - - type: markdown - attributes: - value: | - Usa questo template per proporre un **nuovo progetto** del DataCivicLab. - - - type: textarea - id: domanda - attributes: - label: 🎯 Domanda civica - description: Una sola frase chiara. - validations: - required: true - - - type: textarea - id: obiettivo - attributes: - label: 📌 Obiettivo del progetto - description: Cosa produrremo e per chi? - validations: - required: true - - - type: textarea - id: dataset - attributes: - label: 📊 Dataset coinvolti - description: Dataset — Fonte — Periodo — Livello. - - - type: dropdown - id: output - attributes: - label: 🛠️ Output previsto - options: - - Dashboard - - Report - - Pagina pubblica - - Altro - - - type: dropdown - id: complessita - attributes: - label: ⏱️ Complessità stimata - options: - - Bassa - - Media - - Alta - - - type: dropdown - id: stato - attributes: - label: 🚦 Stato - options: - - Idea - - In discussione - - Pronto per Issue - - In corso \ No newline at end of file diff --git a/.github/DISCUSSION_TEMPLATE/question.yml b/.github/DISCUSSION_TEMPLATE/question.yml new file mode 100644 index 0000000..35df7c8 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/question.yml @@ -0,0 +1,23 @@ +title: "[Question] " +body: + - type: markdown + attributes: + value: | + Usa questo template per fare una domanda pubblica o chiedere orientamento. + - type: textarea + id: question + attributes: + label: Domanda + description: Spiega cosa vuoi capire o decidere + validations: + required: true + - type: input + id: repo + attributes: + label: Repository coinvolto + placeholder: Se lo sai gia' + - type: textarea + id: context + attributes: + label: Contesto utile + description: Link, riferimenti o tentativi gia' fatti diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md deleted file mode 100644 index 31a2b2b..0000000 --- a/.github/ISSUE_TEMPLATE/bug.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -name: 🐛 Bug -about: Segnalazione problema tecnico -title: "[Bug] Descrizione breve" -label: "bug" -type: bug ---- - -## 🧾 Problema -Descrizione chiara e sintetica del bug. - -## 🔁 Come riprodurlo -1. -2. -3. - -## 📍 Dove accade -Repo / file / notebook / ambiente - -## 🎯 Comportamento atteso -Cosa dovrebbe succedere invece? \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..239214c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,39 @@ +name: Bug report +description: Segnala un problema chiaro e riproducibile +title: "[Bug] " +labels: + - bug +body: + - type: textarea + id: problem + attributes: + label: Problema + description: Descrivi cosa non funziona + validations: + required: true + - type: textarea + id: steps + attributes: + label: Come riprodurlo + description: Elenca i passaggi minimi per vedere il problema + placeholder: | + 1. ... + 2. ... + 3. ... + validations: + required: true + - type: input + id: repo + attributes: + label: Repository coinvolto + placeholder: es. toolkit, project-template, nome repo dataset + - type: textarea + id: expected + attributes: + label: Comportamento atteso + description: Cosa ti aspettavi + - type: textarea + id: context + attributes: + label: Contesto utile + description: Link, screenshot o riferimenti che aiutano a capire diff --git a/.github/ISSUE_TEMPLATE/change_request.yml b/.github/ISSUE_TEMPLATE/change_request.yml new file mode 100644 index 0000000..ff105be --- /dev/null +++ b/.github/ISSUE_TEMPLATE/change_request.yml @@ -0,0 +1,38 @@ +name: Change request +description: Proponi un miglioramento concreto o un lavoro da fare +title: "[Change] " +labels: + - needs-triage +body: + - type: textarea + id: outcome + attributes: + label: Cosa dovrebbe cambiare + description: Descrivi il risultato atteso in modo concreto + validations: + required: true + - type: textarea + id: why + attributes: + label: Perche' serve + description: Spiega il problema o l'opportunita' che questa issue affronta + validations: + required: true + - type: input + id: repo + attributes: + label: Repository coinvolto + placeholder: es. .github, toolkit, project-template + - type: textarea + id: done + attributes: + label: Quando possiamo considerarla chiusa + description: Elenca i criteri minimi di completamento + placeholder: | + - ... + - ... + - type: textarea + id: links + attributes: + label: Collegamenti utili + description: Discussion, issue o PR correlate diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index e4b3db1..7f2f7b6 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,5 +1,11 @@ -blank_issues_enabled: true +blank_issues_enabled: false contact_links: - - name: 💬 Discussions - url: https://github.com/dataciviclab/dataciviclab/discussions - about: Per idee, metodo e confronto usa le Discussions. \ No newline at end of file + - name: Discussions + url: https://github.com/orgs/dataciviclab/discussions + about: Usa le discussions per domande, idee e orientamento. + - name: Support + url: https://github.com/dataciviclab/.github/blob/main/SUPPORT.md + about: Leggi la guida rapida ai canali di supporto. + - name: Security + url: https://github.com/dataciviclab/.github/blob/main/SECURITY.md + about: Non usare issue pubbliche per vulnerabilita' o contenuti sensibili. diff --git a/.github/ISSUE_TEMPLATE/task.md b/.github/ISSUE_TEMPLATE/task.md deleted file mode 100644 index 5db7755..0000000 --- a/.github/ISSUE_TEMPLATE/task.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: 🛠 Task -about: Attività operativa da completare -title: "[Task] Titolo breve e chiaro" -type: task ---- - -## 🎯 Obiettivo -Cosa deve essere fatto? - -## 📦 Contesto -Perché è necessario? - -## ✅ Criteri di completamento -- [ ] -- [ ] -- [ ] - -## 🔗 Collegamenti -Issue correlate / Discussion / PR \ No newline at end of file From 65fa8e0dcf78d9f37d6e346db289a153deecd88d Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 13:31:18 +0000 Subject: [PATCH 03/14] restore org issue and discussion templates --- .github/DISCUSSION_TEMPLATE/datasets.yml | 28 +++++++++ .github/DISCUSSION_TEMPLATE/domande.yml | 16 ++++++ .github/DISCUSSION_TEMPLATE/idea.yml | 28 --------- .github/DISCUSSION_TEMPLATE/introduction.yml | 23 -------- .github/DISCUSSION_TEMPLATE/metodo.yml | 27 +++++++++ .github/DISCUSSION_TEMPLATE/presentazioni.yml | 40 +++++++++++++ .github/DISCUSSION_TEMPLATE/proposte.yml | 57 +++++++++++++++++++ .github/DISCUSSION_TEMPLATE/question.yml | 23 -------- .github/ISSUE_TEMPLATE/bug.md | 21 +++++++ .github/ISSUE_TEMPLATE/bug_report.yml | 39 ------------- .github/ISSUE_TEMPLATE/change_request.yml | 38 ------------- .github/ISSUE_TEMPLATE/config.yml | 14 ++--- .github/ISSUE_TEMPLATE/task.md | 20 +++++++ 13 files changed, 213 insertions(+), 161 deletions(-) create mode 100644 .github/DISCUSSION_TEMPLATE/datasets.yml create mode 100644 .github/DISCUSSION_TEMPLATE/domande.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/idea.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/introduction.yml create mode 100644 .github/DISCUSSION_TEMPLATE/metodo.yml create mode 100644 .github/DISCUSSION_TEMPLATE/presentazioni.yml create mode 100644 .github/DISCUSSION_TEMPLATE/proposte.yml delete mode 100644 .github/DISCUSSION_TEMPLATE/question.yml create mode 100644 .github/ISSUE_TEMPLATE/bug.md delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml delete mode 100644 .github/ISSUE_TEMPLATE/change_request.yml create mode 100644 .github/ISSUE_TEMPLATE/task.md diff --git a/.github/DISCUSSION_TEMPLATE/datasets.yml b/.github/DISCUSSION_TEMPLATE/datasets.yml new file mode 100644 index 0000000..257e977 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/datasets.yml @@ -0,0 +1,28 @@ +title: "[Dataset] Nome dataset" +body: + - type: markdown + attributes: + value: | + Usa questo template per discutere una nuova fonte dati prima di aprire una Issue operativa. + + - type: input + id: fonte + attributes: + label: 🔗 Fonte ufficiale + placeholder: URL dataset + + - type: textarea + id: descrizione + attributes: + label: 🧾 Cosa contiene? + description: Descrizione sintetica del dataset + + - type: textarea + id: struttura + attributes: + label: 🏗 Struttura dati + + - type: textarea + id: criticita + attributes: + label: ⚠ Limiti o rischi diff --git a/.github/DISCUSSION_TEMPLATE/domande.yml b/.github/DISCUSSION_TEMPLATE/domande.yml new file mode 100644 index 0000000..46931b8 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/domande.yml @@ -0,0 +1,16 @@ +title: "[Domanda] Quesito analitico" +body: + - type: textarea + id: perche + attributes: + label: 🎯 Perché questa domanda è rilevante? + + - type: textarea + id: metriche + attributes: + label: 📏 Metriche possibili + + - type: textarea + id: ipotesi + attributes: + label: 🧠 Ipotesi iniziali diff --git a/.github/DISCUSSION_TEMPLATE/idea.yml b/.github/DISCUSSION_TEMPLATE/idea.yml deleted file mode 100644 index 083050b..0000000 --- a/.github/DISCUSSION_TEMPLATE/idea.yml +++ /dev/null @@ -1,28 +0,0 @@ -title: "[Idea] " -body: - - type: markdown - attributes: - value: | - Usa questo template per proporre un'idea prima di aprire una issue operativa. - - type: textarea - id: idea - attributes: - label: Idea - description: Descrivi la proposta in modo semplice - validations: - required: true - - type: textarea - id: why - attributes: - label: Perche' potrebbe essere utile - description: Quale bisogno o opportunita' vedi - - type: input - id: repo - attributes: - label: Repository coinvolto - placeholder: Se lo sai gia' - - type: textarea - id: next - attributes: - label: Prossimo passo possibile - description: Cosa servirebbe per trasformarla in issue diff --git a/.github/DISCUSSION_TEMPLATE/introduction.yml b/.github/DISCUSSION_TEMPLATE/introduction.yml deleted file mode 100644 index 6000d2a..0000000 --- a/.github/DISCUSSION_TEMPLATE/introduction.yml +++ /dev/null @@ -1,23 +0,0 @@ -title: "[Intro] " -body: - - type: markdown - attributes: - value: | - Usa questo template per presentarti alla community e dire da dove vuoi iniziare. - - type: textarea - id: who - attributes: - label: Chi sei - description: Una breve presentazione - validations: - required: true - - type: textarea - id: interests - attributes: - label: Cosa ti interessa - description: Temi, repository o tipi di contributo che ti attirano - - type: textarea - id: help - attributes: - label: Come possiamo orientarti - description: Se hai gia' una domanda o un primo passo in mente diff --git a/.github/DISCUSSION_TEMPLATE/metodo.yml b/.github/DISCUSSION_TEMPLATE/metodo.yml new file mode 100644 index 0000000..eff980e --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/metodo.yml @@ -0,0 +1,27 @@ +title: "[Metodo] Scelta metodologica" +body: + - type: markdown + attributes: + value: | + Usa questo template per discutere scelte metodologiche prima di implementarle. + + - type: textarea + id: contesto + attributes: + label: 🧩 Contesto + required: true + + - type: textarea + id: scelta + attributes: + label: ⚙ Proposta metodologica + + - type: textarea + id: alternative + attributes: + label: 🔄 Alternative valutate + + - type: textarea + id: impatto + attributes: + label: 📊 Impatto su replicabilità e confronto diff --git a/.github/DISCUSSION_TEMPLATE/presentazioni.yml b/.github/DISCUSSION_TEMPLATE/presentazioni.yml new file mode 100644 index 0000000..4b0bbd7 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/presentazioni.yml @@ -0,0 +1,40 @@ +title: "[Presentazione] Nome o nickname" +body: + - type: markdown + attributes: + value: | + Usa questo template per presentarti alla community DataCivicLab. + + - type: textarea + id: bio + attributes: + label: 👤 Chi sei + description: Breve bio (2–3 righe). + validations: + required: true + + - type: textarea + id: competenze + attributes: + label: 🧠 Competenze + description: Dati, analisi, visualizzazione, metodo, altro. + + - type: textarea + id: interessi + attributes: + label: 💡 Cosa ti interessa + description: Temi civici, dataset, progetti. + + - type: dropdown + id: disponibilita + attributes: + label: ⏱️ Disponibilità + options: + - Occasionale + - Continuativa + + - type: textarea + id: contributo + attributes: + label: 🤝 Come vorresti contribuire + description: Discussioni, analisi, doc, QA, altro. diff --git a/.github/DISCUSSION_TEMPLATE/proposte.yml b/.github/DISCUSSION_TEMPLATE/proposte.yml new file mode 100644 index 0000000..0a0f59c --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/proposte.yml @@ -0,0 +1,57 @@ +title: "[Progetto] Titolo del progetto" +body: + - type: markdown + attributes: + value: | + Usa questo template per proporre un **nuovo progetto** del DataCivicLab. + + - type: textarea + id: domanda + attributes: + label: 🎯 Domanda civica + description: Una sola frase chiara. + validations: + required: true + + - type: textarea + id: obiettivo + attributes: + label: 📌 Obiettivo del progetto + description: Cosa produrremo e per chi? + validations: + required: true + + - type: textarea + id: dataset + attributes: + label: 📊 Dataset coinvolti + description: Dataset — Fonte — Periodo — Livello. + + - type: dropdown + id: output + attributes: + label: 🛠️ Output previsto + options: + - Dashboard + - Report + - Pagina pubblica + - Altro + + - type: dropdown + id: complessita + attributes: + label: ⏱️ Complessità stimata + options: + - Bassa + - Media + - Alta + + - type: dropdown + id: stato + attributes: + label: 🚦 Stato + options: + - Idea + - In discussione + - Pronto per Issue + - In corso diff --git a/.github/DISCUSSION_TEMPLATE/question.yml b/.github/DISCUSSION_TEMPLATE/question.yml deleted file mode 100644 index 35df7c8..0000000 --- a/.github/DISCUSSION_TEMPLATE/question.yml +++ /dev/null @@ -1,23 +0,0 @@ -title: "[Question] " -body: - - type: markdown - attributes: - value: | - Usa questo template per fare una domanda pubblica o chiedere orientamento. - - type: textarea - id: question - attributes: - label: Domanda - description: Spiega cosa vuoi capire o decidere - validations: - required: true - - type: input - id: repo - attributes: - label: Repository coinvolto - placeholder: Se lo sai gia' - - type: textarea - id: context - attributes: - label: Contesto utile - description: Link, riferimenti o tentativi gia' fatti diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md new file mode 100644 index 0000000..20ccc58 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.md @@ -0,0 +1,21 @@ +--- +name: 🐛 Bug +about: Segnalazione problema tecnico +title: "[Bug] Descrizione breve" +label: "bug" +type: bug +--- + +## 🧾 Problema +Descrizione chiara e sintetica del bug. + +## 🔁 Come riprodurlo +1. +2. +3. + +## 📍 Dove accade +Repo / file / notebook / ambiente + +## 🎯 Comportamento atteso +Cosa dovrebbe succedere invece? diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml deleted file mode 100644 index 239214c..0000000 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ /dev/null @@ -1,39 +0,0 @@ -name: Bug report -description: Segnala un problema chiaro e riproducibile -title: "[Bug] " -labels: - - bug -body: - - type: textarea - id: problem - attributes: - label: Problema - description: Descrivi cosa non funziona - validations: - required: true - - type: textarea - id: steps - attributes: - label: Come riprodurlo - description: Elenca i passaggi minimi per vedere il problema - placeholder: | - 1. ... - 2. ... - 3. ... - validations: - required: true - - type: input - id: repo - attributes: - label: Repository coinvolto - placeholder: es. toolkit, project-template, nome repo dataset - - type: textarea - id: expected - attributes: - label: Comportamento atteso - description: Cosa ti aspettavi - - type: textarea - id: context - attributes: - label: Contesto utile - description: Link, screenshot o riferimenti che aiutano a capire diff --git a/.github/ISSUE_TEMPLATE/change_request.yml b/.github/ISSUE_TEMPLATE/change_request.yml deleted file mode 100644 index ff105be..0000000 --- a/.github/ISSUE_TEMPLATE/change_request.yml +++ /dev/null @@ -1,38 +0,0 @@ -name: Change request -description: Proponi un miglioramento concreto o un lavoro da fare -title: "[Change] " -labels: - - needs-triage -body: - - type: textarea - id: outcome - attributes: - label: Cosa dovrebbe cambiare - description: Descrivi il risultato atteso in modo concreto - validations: - required: true - - type: textarea - id: why - attributes: - label: Perche' serve - description: Spiega il problema o l'opportunita' che questa issue affronta - validations: - required: true - - type: input - id: repo - attributes: - label: Repository coinvolto - placeholder: es. .github, toolkit, project-template - - type: textarea - id: done - attributes: - label: Quando possiamo considerarla chiusa - description: Elenca i criteri minimi di completamento - placeholder: | - - ... - - ... - - type: textarea - id: links - attributes: - label: Collegamenti utili - description: Discussion, issue o PR correlate diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 7f2f7b6..3e705ee 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,11 +1,5 @@ -blank_issues_enabled: false +blank_issues_enabled: true contact_links: - - name: Discussions - url: https://github.com/orgs/dataciviclab/discussions - about: Usa le discussions per domande, idee e orientamento. - - name: Support - url: https://github.com/dataciviclab/.github/blob/main/SUPPORT.md - about: Leggi la guida rapida ai canali di supporto. - - name: Security - url: https://github.com/dataciviclab/.github/blob/main/SECURITY.md - about: Non usare issue pubbliche per vulnerabilita' o contenuti sensibili. + - name: 💬 Discussions + url: https://github.com/dataciviclab/dataciviclab/discussions + about: Per idee, metodo e confronto usa le Discussions. diff --git a/.github/ISSUE_TEMPLATE/task.md b/.github/ISSUE_TEMPLATE/task.md new file mode 100644 index 0000000..a47e415 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/task.md @@ -0,0 +1,20 @@ +--- +name: 🛠 Task +about: Attività operativa da completare +title: "[Task] Titolo breve e chiaro" +type: task +--- + +## 🎯 Obiettivo +Cosa deve essere fatto? + +## 📦 Contesto +Perché è necessario? + +## ✅ Criteri di completamento +- [ ] +- [ ] +- [ ] + +## 🔗 Collegamenti +Issue correlate / Discussion / PR From 2c7fb8e5396b4593c56274aa56adf25c8d7970e1 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 13:40:15 +0000 Subject: [PATCH 04/14] refine org support links and governance copy --- .github/ISSUE_TEMPLATE/config.yml | 4 ++-- GOVERNANCE.md | 1 + README.md | 1 + SECURITY.md | 2 +- SUPPORT.md | 3 ++- profile/README.md | 2 ++ 6 files changed, 9 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 3e705ee..e32457e 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,5 +1,5 @@ blank_issues_enabled: true contact_links: - name: 💬 Discussions - url: https://github.com/dataciviclab/dataciviclab/discussions - about: Per idee, metodo e confronto usa le Discussions. + url: https://github.com/orgs/dataciviclab/discussions + about: Per idee, orientamento e confronto usa le Discussions dell'organizzazione. diff --git a/GOVERNANCE.md b/GOVERNANCE.md index b3c3281..d623727 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -35,3 +35,4 @@ Quando possibile: 3. la decisione finale viene resa visibile nella pull request o nell'issue collegata Se una decisione riguarda un solo repository, vale la documentazione di quel repository. +Se invece riguarda il modo in cui l'organizzazione usa GitHub, il riferimento canonico e' questa repo. diff --git a/README.md b/README.md index d6653d1..9e9ea7b 100644 --- a/README.md +++ b/README.md @@ -19,3 +19,4 @@ Qui non vivono: - bootstrap operativo dei repository dataset Per il contesto generale del Lab e l'indice dell'ecosistema, il punto di ingresso resta la repository `dataciviclab`. +Per domande e confronto pubblico trasversale, il punto di ingresso resta GitHub Discussions dell'organizzazione. diff --git a/SECURITY.md b/SECURITY.md index af45af4..c5a0aac 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -2,7 +2,7 @@ Se trovi una vulnerabilita', non aprire una issue pubblica. -Usa GitHub Security Advisories se disponibili per il repository coinvolto. Se non sono disponibili, contatta i maintainer in modo riservato prima di pubblicare dettagli. +Usa GitHub Security Advisories se disponibili per il repository coinvolto. Se non sono disponibili, contatta in privato i maintainer del repository interessato prima di pubblicare dettagli. Usa i canali pubblici solo per: diff --git a/SUPPORT.md b/SUPPORT.md index 3a4f4bc..e107709 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -4,7 +4,7 @@ Usa il canale giusto in base a quello che ti serve. ## Dove scrivere -- `GitHub Discussions`: domande, idee, orientamento, confronto pubblico +- `GitHub Discussions`: domande, idee, orientamento e confronto pubblico nell'org `dataciviclab` - `Issues`: bug, problemi chiari, attivita' da svolgere - `Pull requests`: proposta di modifica gia' pronta - `Discord`: scambio rapido e informale tra persone della community @@ -14,6 +14,7 @@ Usa il canale giusto in base a quello che ti serve. - controlla se esiste gia' una issue o discussion simile - scegli il repository corretto +- se ti serve solo orientamento, parti dalle Discussions dell'organizzazione - se il tema riguarda metodo dati o implementazione tecnica, usa il repository dedicato ## Sicurezza e comportamento diff --git a/profile/README.md b/profile/README.md index 9cd6007..aeeac4d 100644 --- a/profile/README.md +++ b/profile/README.md @@ -14,6 +14,8 @@ DataCivicLab e' un laboratorio civico che usa dati pubblici, strumenti aperti e - `Issues` per lavoro concreto da fare - `Pull requests` per proporre modifiche +Le Discussions di riferimento sono quelle dell'organizzazione `dataciviclab`. + ## Canali - GitHub Discussions: confronto pubblico e asincrono From 1385f0873217ebd1f10eb4359a03803bb454aca3 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 13:43:27 +0000 Subject: [PATCH 05/14] PR template improvamente --- PULL_REQUEST_TEMPLATE.md | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md index a40ff49..d08f474 100644 --- a/PULL_REQUEST_TEMPLATE.md +++ b/PULL_REQUEST_TEMPLATE.md @@ -1,21 +1,39 @@ -## Summary +## Sintesi Spiega in poche righe cosa cambia e perche'. -## Linked context +## Contesto collegato Closes # -## Type of change +## Cosa cambia -- [ ] Documentation or copy update -- [ ] Policy or template update -- [ ] Community health update -- [ ] Repository-specific change +- +- +- -## Checks +## Impatto -- [ ] Ho verificato che questa PR sia nel repository giusto +Segna solo quello che si applica. + +- [ ] Documentazione o testi +- [ ] Policy GitHub o template +- [ ] Codice o automazioni +- [ ] Pipeline dati o trasformazioni +- [ ] Contenuti o metadati di dataset +- [ ] Nessun impatto visibile per chi usa il repository + +## Verifica + +Spiega come hai verificato il cambiamento. Se non serve, scrivi `N/A`. + +## Controlli + +- [ ] Questa PR e' nel repository giusto - [ ] Ho collegato issue o discussion quando serve -- [ ] Ho mantenuto il cambiamento piccolo e leggibile -- [ ] Ho aggiornato la documentazione solo dove serve davvero +- [ ] Ho verificato l'impatto su documentazione, codice o dati +- [ ] Ho aggiornato solo quello che era davvero necessario + +## Note per chi revisiona + +Segnala qui rischi, limiti o punti su cui vuoi un controllo mirato. From b1ef2ba31384b378eddadaaa365fe83a6c54ad13 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 14:59:34 +0000 Subject: [PATCH 06/14] align onboarding and public channels --- CONTRIBUTING.md | 22 ++++++++++++++++++++-- DISCUSSIONS.md | 17 ++++++++++++++++- README.md | 5 ++++- SUPPORT.md | 6 +++++- profile/README.md | 5 +++-- 5 files changed, 48 insertions(+), 7 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 25d7d78..d2cbc97 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,9 +8,22 @@ Questa guida spiega come entrare in modo semplice nei repository dell'organizzaz Se vuoi capire il contesto generale, parti dalla repository `dataciviclab`. -Se vuoi contribuire a un repository specifico: +Se vuoi contribuire all'organizzazione nel suo insieme: -- leggi il suo `README.md` +- parti dalle [Discussions](https://github.com/orgs/dataciviclab/discussions) dell'org +- guarda [Open Board](https://github.com/orgs/dataciviclab/projects/5) per il lavoro in corso +- guarda [Roadmap](https://github.com/orgs/dataciviclab/projects/2) per capire direzione, progetti e milestone + +Se vuoi contribuire a un repository specifico, usa questa regola semplice: + +- `toolkit`: se vuoi lavorare sul motore tecnico della pipeline dati +- `project-template`: se vuoi migliorare il template operativo da cui nascono i repo dataset +- repo progetto o dataset: se vuoi lavorare su un progetto concreto +- `.github`: se vuoi migliorare policy condivise, onboarding, template o profilo pubblico GitHub + +In ogni caso: + +- leggi il `README.md` del repository - controlla issue e discussions aperte - verifica se esistono istruzioni locali aggiuntive @@ -30,6 +43,11 @@ Le pull request servono a far entrare i cambiamenti in modo chiaro e revisionabi - `Discussions`: domande, idee, confronto iniziale, orientamento - `Issues`: lavoro concreto da fare o problema da risolvere - `Pull requests`: proposta di modifica pronta da rivedere +- `Open Board`: vista pubblica del lavoro in corso +- `Roadmap`: vista pubblica di direzione, progetti e prossime tappe +- `Discord`: scambio veloce o informale, non traccia canonica + +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. diff --git a/DISCUSSIONS.md b/DISCUSSIONS.md index 783a9a5..d4fe794 100644 --- a/DISCUSSIONS.md +++ b/DISCUSSIONS.md @@ -1,4 +1,4 @@ -# Discussions +# Discussions e Projects Le GitHub Discussions sono il posto giusto quando serve parlare prima di implementare. @@ -16,3 +16,18 @@ Non usarle per: - 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/README.md b/README.md index 9e9ea7b..b616568 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ 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: @@ -19,4 +20,6 @@ Qui non vivono: - bootstrap operativo dei repository dataset Per il contesto generale del Lab e l'indice dell'ecosistema, il punto di ingresso resta la repository `dataciviclab`. -Per domande e confronto pubblico trasversale, il punto di ingresso resta GitHub Discussions dell'organizzazione. +Per domande e confronto pubblico trasversale, il punto di ingresso resta [GitHub Discussions](https://github.com/orgs/dataciviclab/discussions) dell'organizzazione. +Per seguire il lavoro in corso, il riferimento e' [Open Board](https://github.com/orgs/dataciviclab/projects/5). +Per vedere direzione, progetti e milestone, il riferimento e' [Roadmap](https://github.com/orgs/dataciviclab/projects/2). diff --git a/SUPPORT.md b/SUPPORT.md index e107709..b2e45a3 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -4,9 +4,11 @@ Usa il canale giusto in base a quello che ti serve. ## Dove scrivere -- `GitHub Discussions`: domande, idee, orientamento e confronto pubblico nell'org `dataciviclab` +- [`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`: scambio rapido e informale tra persone della community - `LinkedIn`: aggiornamenti pubblici, non supporto operativo @@ -15,6 +17,8 @@ Usa il canale giusto in base a quello che ti serve. - 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 diff --git a/profile/README.md b/profile/README.md index aeeac4d..7e4f051 100644 --- a/profile/README.md +++ b/profile/README.md @@ -18,8 +18,9 @@ Le Discussions di riferimento sono quelle dell'organizzazione `dataciviclab`. ## Canali -- GitHub Discussions: confronto pubblico e asincrono -- GitHub Projects: coordinamento operativo dei maintainer +- [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: confronto informale e community - LinkedIn: aggiornamenti pubblici e visibilita' esterna From fb645e0a9d0713703e7252e0481c0a798237542b Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 15:06:27 +0000 Subject: [PATCH 07/14] warm up org profile and contributor guidance --- CONTRIBUTING.md | 12 +++++++++--- README.md | 3 +++ SUPPORT.md | 7 +++++-- profile/README.md | 23 ++++++++++++++--------- 4 files changed, 31 insertions(+), 14 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d2cbc97..2054fe1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,11 +2,14 @@ Grazie per voler contribuire a DataCivicLab. -Questa guida spiega come entrare in modo semplice nei repository dell'organizzazione senza duplicare la documentazione specifica dei singoli progetti. +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 -Se vuoi capire il contesto generale, parti dalla repository `dataciviclab`. +Se vuoi capire il quadro generale, parti dalla repository `dataciviclab`. Se vuoi contribuire all'organizzazione nel suo insieme: @@ -14,7 +17,7 @@ Se vuoi contribuire all'organizzazione nel suo insieme: - guarda [Open Board](https://github.com/orgs/dataciviclab/projects/5) per il lavoro in corso - guarda [Roadmap](https://github.com/orgs/dataciviclab/projects/2) per capire direzione, progetti e milestone -Se vuoi contribuire a un repository specifico, usa questa regola semplice: +Se invece vuoi contribuire a un repository specifico, usa questa regola semplice: - `toolkit`: se vuoi lavorare sul motore tecnico della pipeline dati - `project-template`: se vuoi migliorare il template operativo da cui nascono i repo dataset @@ -27,6 +30,9 @@ In ogni caso: - controlla issue e discussions aperte - verifica se esistono istruzioni locali aggiuntive +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 Nell'organizzazione usiamo un flusso semplice: diff --git a/README.md b/README.md index b616568..7cca504 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,9 @@ Questa repository raccoglie i file condivisi che definiscono l'esperienza GitHub comune di `dataciviclab`. +Non e' l'hub pubblico del Lab. +E' il posto in cui teniamo ordine su GitHub. + Qui vivono: - community health files diff --git a/SUPPORT.md b/SUPPORT.md index b2e45a3..4564c5d 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -1,6 +1,7 @@ # Support -Usa il canale giusto in base a quello che ti serve. +Non serve sapere tutto subito. +Serve solo scegliere il canale giusto per quello che ti serve. ## Dove scrivere @@ -9,9 +10,11 @@ Usa il canale giusto in base a quello che ti serve. - `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`: scambio rapido e informale tra persone della community +- [`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 diff --git a/profile/README.md b/profile/README.md index 7e4f051..4497181 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,27 +1,32 @@ # DataCivicLab -DataCivicLab e' un laboratorio civico che usa dati pubblici, strumenti aperti e collaborazione trasparente per produrre comprensione condivisa. +DataCivicLab e' uno spazio civico dove proviamo a rendere i dati pubblici piu' leggibili, utili e condivisibili. + +Non serve capire tutto subito. +Serve solo capire da dove iniziare. ## Dove iniziare -- `dataciviclab`: hub pubblico e indice dell'organizzazione -- `toolkit`: motore della pipeline dati +- `dataciviclab`: hub pubblico e umano dell'organizzazione +- `toolkit`: motore tecnico della pipeline dati - `project-template`: base operativa dei repository dataset ## Come partecipare -- `Discussions` per domande, idee e confronto iniziale -- `Issues` per lavoro concreto da fare -- `Pull requests` per proporre modifiche +- [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 -Le Discussions di riferimento sono quelle dell'organizzazione `dataciviclab`. +Se non sai ancora dove stare, parti dalle Discussions dell'organizzazione. ## Canali - [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: confronto informale e community +- [Discord](https://discord.gg/rAHpuTrYK3): scambio veloce ed eventi, ma non fonte canonica - LinkedIn: aggiornamenti pubblici e visibilita' esterna -Per contribuire, parti dalle discussions o dal repository piu' vicino al tema su cui vuoi lavorare. +GitHub resta il posto dove deve restare la traccia utile. + +Per contribuire, parti dal canale o dal repository piu' vicino a quello che vuoi capire o migliorare. From 52d52902218a23a3c0bf313f1d0fd82d5f136021 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 15:06:38 +0000 Subject: [PATCH 08/14] soften discussions guidance tone --- DISCUSSIONS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/DISCUSSIONS.md b/DISCUSSIONS.md index d4fe794..097069d 100644 --- a/DISCUSSIONS.md +++ b/DISCUSSIONS.md @@ -1,6 +1,7 @@ # 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: From 0b6da7d673a1afbf734e681e1589cd19502c4f49 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Mon, 2 Mar 2026 15:09:42 +0000 Subject: [PATCH 09/14] add leading emojis to community docs headings --- CODE_OF_CONDUCT.md | 2 +- CONTRIBUTING.md | 12 ++++++------ DISCUSSIONS.md | 4 ++-- GOVERNANCE.md | 8 ++++---- README.md | 2 +- SUPPORT.md | 8 ++++---- profile/README.md | 8 ++++---- 7 files changed, 22 insertions(+), 22 deletions(-) diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 30ee1c9..9add795 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 2054fe1..39e291c 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 index 097069d..b5c6278 100644 --- a/DISCUSSIONS.md +++ b/DISCUSSIONS.md @@ -1,4 +1,4 @@ -# Discussions e Projects +# 💬 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. @@ -18,7 +18,7 @@ Non usarle per: Se da una discussion emerge un lavoro concreto, apri o collega una issue. -## Projects pubblici +## 📌 Projects pubblici In DataCivicLab usiamo due GitHub Projects pubblici: diff --git a/GOVERNANCE.md b/GOVERNANCE.md index d623727..1ccf917 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 7cca504..ecbfa8f 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`. diff --git a/SUPPORT.md b/SUPPORT.md index 4564c5d..706cbc8 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -1,9 +1,9 @@ -# Support +# 🆘 Support Non serve sapere tutto subito. Serve solo scegliere il canale giusto per quello che ti serve. -## Dove scrivere +## 📍 Dove scrivere - [`GitHub Discussions`](https://github.com/orgs/dataciviclab/discussions): domande, idee, orientamento e confronto pubblico nell'org `dataciviclab` - `Issues`: bug, problemi chiari, attivita' da svolgere @@ -15,7 +15,7 @@ Serve solo scegliere il canale giusto per quello che ti serve. Se hai un dubbio e non sai dove andare, la scelta piu' sicura e' iniziare da GitHub Discussions. -## Prima di aprire qualcosa +## 📝 Prima di aprire qualcosa - controlla se esiste gia' una issue o discussion simile - scegli il repository corretto @@ -24,7 +24,7 @@ Se hai un dubbio e non sai dove andare, la scelta piu' sicura e' iniziare da Git - se vuoi capire dove stiamo andando, guarda `Roadmap` - se il tema riguarda metodo dati o implementazione tecnica, usa il repository dedicato -## Sicurezza e comportamento +## 🔐 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 diff --git a/profile/README.md b/profile/README.md index 4497181..17b7a1d 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,17 +1,17 @@ -# DataCivicLab +# 🌍 DataCivicLab DataCivicLab e' uno spazio civico dove proviamo a rendere i dati pubblici piu' leggibili, utili e condivisibili. Non serve capire tutto subito. Serve solo capire da dove iniziare. -## Dove iniziare +## 🌱 Dove iniziare - `dataciviclab`: hub pubblico e umano dell'organizzazione - `toolkit`: motore tecnico della pipeline dati - `project-template`: base operativa dei repository dataset -## Come partecipare +## 🤝 Come partecipare - [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 @@ -19,7 +19,7 @@ Serve solo capire da dove iniziare. Se non sai ancora dove stare, parti dalle Discussions dell'organizzazione. -## Canali +## 🔗 Canali - [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 From b42d970d9bb80903131aba049b52a27d21f26998 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Tue, 3 Mar 2026 10:07:09 +0000 Subject: [PATCH 10/14] link core repos from org profile --- profile/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/profile/README.md b/profile/README.md index 17b7a1d..fd40e3d 100644 --- a/profile/README.md +++ b/profile/README.md @@ -7,9 +7,9 @@ Serve solo capire da dove iniziare. ## 🌱 Dove iniziare -- `dataciviclab`: hub pubblico e umano dell'organizzazione -- `toolkit`: motore tecnico della pipeline dati -- `project-template`: base operativa dei repository dataset +- [`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 ## 🤝 Come partecipare From fa08505226495577f71903dacdc9d912f5444e16 Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Tue, 3 Mar 2026 20:41:52 +0000 Subject: [PATCH 11/14] docs: align discussions and issues flow --- .github/DISCUSSION_TEMPLATE/domande.yml | 9 +++++++++ .github/ISSUE_TEMPLATE/task.md | 2 ++ README.md | 15 +++++++++++++++ 3 files changed, 26 insertions(+) diff --git a/.github/DISCUSSION_TEMPLATE/domande.yml b/.github/DISCUSSION_TEMPLATE/domande.yml index 46931b8..36ee666 100644 --- a/.github/DISCUSSION_TEMPLATE/domande.yml +++ b/.github/DISCUSSION_TEMPLATE/domande.yml @@ -4,13 +4,22 @@ body: id: perche attributes: label: 🎯 Perché questa domanda è rilevante? + description: Spiega il problema pubblico o civico che vuoi capire meglio. - type: textarea id: metriche attributes: label: 📏 Metriche possibili + description: Indica dati, indicatori o confronti che potrebbero aiutare a rispondere. - type: textarea id: ipotesi attributes: label: 🧠 Ipotesi iniziali + description: Se hai gia' un'idea, esplicitala. Se non l'hai, va bene comunque. + + - type: textarea + id: next_step + attributes: + label: 🔁 Se diventa lavoro concreto + description: Indica in quale repo dovrebbe nascere una issue operativa e quale sarebbe il primo output utile. diff --git a/.github/ISSUE_TEMPLATE/task.md b/.github/ISSUE_TEMPLATE/task.md index a47e415..f812504 100644 --- a/.github/ISSUE_TEMPLATE/task.md +++ b/.github/ISSUE_TEMPLATE/task.md @@ -18,3 +18,5 @@ Perché è necessario? ## 🔗 Collegamenti Issue correlate / Discussion / PR + +Se il task nasce da una domanda civica o da una proposta di analisi, collega qui la Discussion di origine. diff --git a/README.md b/README.md index ecbfa8f..7df41de 100644 --- a/README.md +++ b/README.md @@ -26,3 +26,18 @@ Per il contesto generale del Lab e l'indice dell'ecosistema, il punto di ingress Per domande e confronto pubblico trasversale, il punto di ingresso resta [GitHub Discussions](https://github.com/orgs/dataciviclab/discussions) dell'organizzazione. Per seguire il lavoro in corso, il riferimento e' [Open Board](https://github.com/orgs/dataciviclab/projects/5). Per vedere direzione, progetti e milestone, il riferimento e' [Roadmap](https://github.com/orgs/dataciviclab/projects/2). + +## Flusso consigliato + +Su GitHub cerchiamo di tenere distinti i livelli: + +- **Discussions** per formulare domande civiche, proposte, interpretazioni e bisogno informativo +- **Issues** per il lavoro operativo che ne deriva +- **PR** per le modifiche effettive a codice, documentazione o progetto + +In breve: + +`Discussion -> Issue -> PR` + +Non tutte le issue nascono da una discussion. +Ma quando il punto di partenza e una domanda civica o una proposta di analisi, la discussion e il posto giusto per iniziare. From 7150206274591cc433029be7dea37e04fc92a9cc Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Tue, 3 Mar 2026 21:14:01 +0000 Subject: [PATCH 12/14] ci: validate github templates --- .github/workflows/templates.yml | 56 +++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 .github/workflows/templates.yml diff --git a/.github/workflows/templates.yml b/.github/workflows/templates.yml new file mode 100644 index 0000000..cc8cd08 --- /dev/null +++ b/.github/workflows/templates.yml @@ -0,0 +1,56 @@ +name: Templates + +on: + push: + branches: + - main + pull_request: + +jobs: + validate-templates: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Set up Python + uses: actions/setup-python@v5 + with: + python-version: "3.11" + + - name: Install PyYAML + run: python -m pip install pyyaml + + - name: Validate discussion and issue templates + run: | + python - <<'PY' + from pathlib import Path + import yaml + + root = Path(".").resolve() / ".github" + errors = [] + + for path in sorted((root / "DISCUSSION_TEMPLATE").glob("*.yml")): + try: + yaml.safe_load(path.read_text(encoding="utf-8")) + except Exception as exc: + errors.append(f"{path.relative_to(root.parent)}: {exc}") + + for path in sorted((root / "ISSUE_TEMPLATE").glob("*.md")): + text = path.read_text(encoding="utf-8") + if not text.startswith("---"): + errors.append(f"{path.relative_to(root.parent)}: missing frontmatter start") + continue + parts = text.split("---", 2) + if len(parts) < 3: + errors.append(f"{path.relative_to(root.parent)}: invalid frontmatter") + continue + frontmatter = parts[1] + try: + yaml.safe_load(frontmatter) + except Exception as exc: + errors.append(f"{path.relative_to(root.parent)}: {exc}") + + if errors: + raise SystemExit("Template validation failed:\n" + "\n".join(errors)) + PY From abadc5b7e00eadc52bd8039737f8d0d41aac3c6a Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Thu, 5 Mar 2026 15:21:32 +0000 Subject: [PATCH 13/14] chore: add .gitattributes and .editorconfig (UTF-8, LF) --- .editorconfig | 10 ++++++++++ .gitattributes | 1 + 2 files changed, 11 insertions(+) create mode 100644 .editorconfig create mode 100644 .gitattributes diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..4d761dd --- /dev/null +++ b/.editorconfig @@ -0,0 +1,10 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true + +[*.md] +trim_trailing_whitespace = false diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..6313b56 --- /dev/null +++ b/.gitattributes @@ -0,0 +1 @@ +* text=auto eol=lf From 1dd726358c6cafa7d611d302d427dfa8ac8d1e2e Mon Sep 17 00:00:00 2001 From: Zio Gabber <78922322+Gabrymi93@users.noreply.github.com> Date: Thu, 5 Mar 2026 15:32:42 +0000 Subject: [PATCH 14/14] docs: normalize italian wording in discussion templates --- .github/DISCUSSION_TEMPLATE/datasets.yml | 8 ++++---- .github/DISCUSSION_TEMPLATE/domande.yml | 10 +++++----- .github/DISCUSSION_TEMPLATE/metodo.yml | 8 ++++---- .github/DISCUSSION_TEMPLATE/presentazioni.yml | 12 ++++++------ .github/DISCUSSION_TEMPLATE/proposte.yml | 14 +++++++------- 5 files changed, 26 insertions(+), 26 deletions(-) diff --git a/.github/DISCUSSION_TEMPLATE/datasets.yml b/.github/DISCUSSION_TEMPLATE/datasets.yml index 257e977..f1952a9 100644 --- a/.github/DISCUSSION_TEMPLATE/datasets.yml +++ b/.github/DISCUSSION_TEMPLATE/datasets.yml @@ -8,21 +8,21 @@ body: - type: input id: fonte attributes: - label: 🔗 Fonte ufficiale + label: Fonte ufficiale placeholder: URL dataset - type: textarea id: descrizione attributes: - label: 🧾 Cosa contiene? + label: Cosa contiene? description: Descrizione sintetica del dataset - type: textarea id: struttura attributes: - label: 🏗 Struttura dati + label: Struttura dati - type: textarea id: criticita attributes: - label: ⚠ Limiti o rischi + label: Limiti o rischi diff --git a/.github/DISCUSSION_TEMPLATE/domande.yml b/.github/DISCUSSION_TEMPLATE/domande.yml index 36ee666..dd42e0e 100644 --- a/.github/DISCUSSION_TEMPLATE/domande.yml +++ b/.github/DISCUSSION_TEMPLATE/domande.yml @@ -3,23 +3,23 @@ body: - type: textarea id: perche attributes: - label: 🎯 Perché questa domanda è rilevante? + label: Perché questa domanda è rilevante? description: Spiega il problema pubblico o civico che vuoi capire meglio. - type: textarea id: metriche attributes: - label: 📏 Metriche possibili + label: Metriche possibili description: Indica dati, indicatori o confronti che potrebbero aiutare a rispondere. - type: textarea id: ipotesi attributes: - label: 🧠 Ipotesi iniziali - description: Se hai gia' un'idea, esplicitala. Se non l'hai, va bene comunque. + label: Ipotesi iniziali + description: Se hai già un'idea, esplicitala. Se non l'hai, va bene comunque. - type: textarea id: next_step attributes: - label: 🔁 Se diventa lavoro concreto + label: Se diventa lavoro concreto description: Indica in quale repo dovrebbe nascere una issue operativa e quale sarebbe il primo output utile. diff --git a/.github/DISCUSSION_TEMPLATE/metodo.yml b/.github/DISCUSSION_TEMPLATE/metodo.yml index eff980e..623bba2 100644 --- a/.github/DISCUSSION_TEMPLATE/metodo.yml +++ b/.github/DISCUSSION_TEMPLATE/metodo.yml @@ -8,20 +8,20 @@ body: - type: textarea id: contesto attributes: - label: 🧩 Contesto + label: Contesto required: true - type: textarea id: scelta attributes: - label: ⚙ Proposta metodologica + label: Proposta metodologica - type: textarea id: alternative attributes: - label: 🔄 Alternative valutate + label: Alternative valutate - type: textarea id: impatto attributes: - label: 📊 Impatto su replicabilità e confronto + label: Impatto su replicabilità e confronto diff --git a/.github/DISCUSSION_TEMPLATE/presentazioni.yml b/.github/DISCUSSION_TEMPLATE/presentazioni.yml index 4b0bbd7..68f3b9c 100644 --- a/.github/DISCUSSION_TEMPLATE/presentazioni.yml +++ b/.github/DISCUSSION_TEMPLATE/presentazioni.yml @@ -8,27 +8,27 @@ body: - type: textarea id: bio attributes: - label: 👤 Chi sei - description: Breve bio (2–3 righe). + label: Chi sei + description: Breve bio (2-3 righe). validations: required: true - type: textarea id: competenze attributes: - label: 🧠 Competenze + label: Competenze description: Dati, analisi, visualizzazione, metodo, altro. - type: textarea id: interessi attributes: - label: 💡 Cosa ti interessa + label: Cosa ti interessa description: Temi civici, dataset, progetti. - type: dropdown id: disponibilita attributes: - label: ⏱️ Disponibilità + label: Disponibilità options: - Occasionale - Continuativa @@ -36,5 +36,5 @@ body: - type: textarea id: contributo attributes: - label: 🤝 Come vorresti contribuire + label: Come vorresti contribuire description: Discussioni, analisi, doc, QA, altro. diff --git a/.github/DISCUSSION_TEMPLATE/proposte.yml b/.github/DISCUSSION_TEMPLATE/proposte.yml index 0a0f59c..9e2b58f 100644 --- a/.github/DISCUSSION_TEMPLATE/proposte.yml +++ b/.github/DISCUSSION_TEMPLATE/proposte.yml @@ -8,7 +8,7 @@ body: - type: textarea id: domanda attributes: - label: 🎯 Domanda civica + label: Domanda civica description: Una sola frase chiara. validations: required: true @@ -16,7 +16,7 @@ body: - type: textarea id: obiettivo attributes: - label: 📌 Obiettivo del progetto + label: Obiettivo del progetto description: Cosa produrremo e per chi? validations: required: true @@ -24,13 +24,13 @@ body: - type: textarea id: dataset attributes: - label: 📊 Dataset coinvolti - description: Dataset — Fonte — Periodo — Livello. + label: Dataset coinvolti + description: Dataset - Fonte - Periodo - Livello. - type: dropdown id: output attributes: - label: 🛠️ Output previsto + label: Output previsto options: - Dashboard - Report @@ -40,7 +40,7 @@ body: - type: dropdown id: complessita attributes: - label: ⏱️ Complessità stimata + label: Complessità stimata options: - Bassa - Media @@ -49,7 +49,7 @@ body: - type: dropdown id: stato attributes: - label: 🚦 Stato + label: Stato options: - Idea - In discussione