Skip to content

[META] Consolidare .github come layer canonico di policy e UX GitHub di DataCivicLab #15

@Gabrymi93

Description

@Gabrymi93

Perche' questa issue conta

Dopo il riordino dell'organizzazione DataCivicLab, anche .github deve avere un perimetro molto chiaro e stabile.

Il ruolo corretto delle repo e':

  • .github = policy condivise, community health e UX organizzativa GitHub
  • dataciviclab = hub/core/indice pubblico dell'ecosistema
  • toolkit = motore della pipeline dati
  • project-template = template operativo da cui nascono i repo dataset
  • repo dataset = implementazioni specifiche

.github non deve diventare un posto dove vivere roadmap del Lab, metodo dati, cataloghi dataset o documentazione tecnica del toolkit.
Deve restare il layer comune che orienta persone, contributi, template e canali GitHub.

Obiettivo

Rendere .github la repo canonica per onboarding contributor, community health, policy comuni di collaborazione e instradamento dei canali organizzativi, mantenendo tutto minimale, leggibile e sostenibile.

Checklist

  • Verificare che il README.md spieghi con chiarezza cosa vive in .github e cosa no
  • Verificare che profile/README.md presenti DataCivicLab come organizzazione senza duplicare contenuti da dataciviclab
  • Verificare che CONTRIBUTING.md resti una guida leggera di ingresso cross-repo e non una guida tecnica di progetto
  • Verificare che CODE_OF_CONDUCT.md e SUPPORT.md siano chiari, pubblici e adatti a tutta l'organizzazione
  • Verificare che GOVERNANCE.md descriva solo la collaborazione cross-repo su GitHub
  • Verificare che SECURITY.md esista solo come policy essenziale e non come documento ridondante
  • Verificare che PULL_REQUEST_TEMPLATE.md sia adatto a tutti i repository dell'ecosistema
  • Verificare che issue templates e discussion templates restino utili senza spostare qui metodo dati o documentazione tecnica
  • Verificare che i riferimenti a GitHub Discussions puntino al livello corretto dell'organizzazione

Output atteso

Una repository .github essenziale, chiara e autorevole come punto unico delle policy condivise e dell'esperienza organizzativa GitHub di DataCivicLab.

File da toccare

  • README.md
  • profile/README.md
  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.md
  • GOVERNANCE.md
  • SUPPORT.md
  • SECURITY.md
  • PULL_REQUEST_TEMPLATE.md
  • .github/ISSUE_TEMPLATE/*
  • .github/DISCUSSION_TEMPLATE/*
  • eventuali file fuori ruolo da deprecare o rimuovere

Acceptance criteria

  • chi arriva in .github capisce subito che questa repo e' il layer comune GitHub dell'organizzazione
  • .github non duplica contenuti che devono stare in dataciviclab, toolkit o project-template
  • onboarding, supporto, sicurezza e collaborazione sono spiegati in modo semplice e pubblico
  • i template GitHub sono coerenti con l'uso organizzativo reale
  • i canali esterni sono instradati bene ma senza documentazione superflua
  • la repo resta minimale e sostenibile nel tempo

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Type

Projects

Status

Completato

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions