-
Notifications
You must be signed in to change notification settings - Fork 0
[META] Consolidare .github come layer canonico di policy e UX GitHub di DataCivicLab #15
Copy link
Copy link
Closed
Copy link
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
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 GitHubdataciviclab= hub/core/indice pubblico dell'ecosistematoolkit= motore della pipeline datiproject-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.mdspieghi con chiarezza cosa vive in.githube cosa no - Verificare che
profile/README.mdpresenti DataCivicLab come organizzazione senza duplicare contenuti dadataciviclab - Verificare che
CONTRIBUTING.mdresti una guida leggera di ingresso cross-repo e non una guida tecnica di progetto - Verificare che
CODE_OF_CONDUCT.mdeSUPPORT.mdsiano chiari, pubblici e adatti a tutta l'organizzazione - Verificare che
GOVERNANCE.mddescriva solo la collaborazione cross-repo su GitHub - Verificare che
SECURITY.mdesista solo come policy essenziale e non come documento ridondante - Verificare che
PULL_REQUEST_TEMPLATE.mdsia 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.mdprofile/README.mdCONTRIBUTING.mdCODE_OF_CONDUCT.mdGOVERNANCE.mdSUPPORT.mdSECURITY.mdPULL_REQUEST_TEMPLATE.md.github/ISSUE_TEMPLATE/*.github/DISCUSSION_TEMPLATE/*- eventuali file fuori ruolo da deprecare o rimuovere
Acceptance criteria
- chi arriva in
.githubcapisce subito che questa repo e' il layer comune GitHub dell'organizzazione .githubnon duplica contenuti che devono stare indataciviclab,toolkitoproject-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
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Type
Projects
Status
Completato