# [DRAFT] Schémas du Socle commun des données locales (SCDL)
Ce dépôt sert à indexer les schémas du SCDL afin de permettre [leur documentation](http://scdl.opendatafrance.net/) et leur utilisation dans [Validata](https://go.validata.fr/).
Le [Socle commun des données locales](http://opendatalocale.net/scdl/)(SCDL) est un dispositif d'[OpenDataFrance](http://opendatafrance.net/) visant à définir un ensemble de jeux de données prioritaires, normalisés et communs aux collectivités territoriales françaises. Chaque jeu de données identifié fait l'objet d'un schéma : un document décrivant la structure, les champs et les contenus attendus.
Les schémas sont écrits au format [Table Schema](https://frictionlessdata.io/specs/table-schema/). Une documentation est générée automatiquement au format Markdown et publiée sur [scdl.opendatafrance.net](http://scdl.opendatafrance.net/).
## Liste des schémas du SCDL
| Nom | Version | Mainteneur | Dépôt | JSON | Doc |
Prochainement, le processus de contribution sera donc de faire une merge request sur ce dépôt (instructions à venir).
### Critères d'acceptation
Pour faire partie du SCDL, un schéma doit être écrit en JSON conformément aux spécifications [Table Schema](https://frictionlessdata.io/specs/table-schema/). Ce fichier `schema.json` doit publié dans un dépôt Git, auquel doivent être adjoints les ressources complémentaires suivantes :
*`CONTEXT.md`
*`SEE_ALSO.md`
Ces deux documents permettent de compléter les informations contextuelles inhérentes au schéma, et sont insérés [dans la documentation générée pour chaque schéma](https://scdl.opendatafrance.net/), en début et en fin de page.
Un fichier `CHANGELOG.md`, plus classique, apporte les informations sur les différentes mises à jour du schéma.
Des données tabulaires d'exemple en CSV, valides ou invalides, peuvent être également ajoutés dans un dossier séparé.
Nous recommandons par ailleurs l'usage des tags Git pour figer les versions de chaque schéma ainsi que les fichiers afférents cités ci-dessus. Plus d'informations à ce sujet [dans la documentation sur le cycle de vie des schémas dans Validata](https://git.opendatafrance.net/validata/validata-core/wikis/release-process).
Enfin, [OpenDataFrance](http://opendatafrance.net/) se réserve le droit d'accepter ou de refuser l'ajout d'un schéma au sein du SCDL.