# Recommandations relatives aux schémas de validation

## Recommandations pour la création des schémas

Dès que le draft d'une spécification du Socle Commun des Données Locales est suffisamment mûr, son contenu est implémenté, ajusté si nécessaire, et stabilisé dans un schéma json au format [*Table Schema*](https://frictionlessdata.io/specs/table-schema/). Ce format a été défini dans le cadre du projet [Frictionless Data](https://frictionlessdata.io/) porté par [Open Knowledge International](https://okfn.org/). En s'y conformant, les schémas du SCDL peuvent être utilisés pour valider des données tabulaires via des outils tels que ceux proposés sur la plateforme [Validata](http://validata.fr).

Méthodologie proposée par Charles Népote (Fing) : [https://docs.google.com/document/d/1zMHb\_98c5XA7yGKnL4u7-WFmA5BNTczJ3kBHCoWmtW4/edit#](https://docs.google.com/document/d/1zMHb_98c5XA7yGKnL4u7-WFmA5BNTczJ3kBHCoWmtW4/edit)

## Recommandations pour la mise à jour des schémas

Quand une spécification est implémentée, son schéma est référencé sur le [GitLab d'OpenDataFrance](https://git.opendatafrance.net/scdl). Certains schémas sont hébergés dans des dépôts dédiés et d'autres dans des dépôts distants, notamment sur Github. Les éventuelles modifications à leur apporter sont alors directement opérées par leur(s) auteur(s).

Pour signaler un problème ou suggérer une amélioration, il est recommandé d'utiliser le système de tickets ('issues') de chaque dépôt.

## Recommandations pour le versionnage des schémas

Pour assurer le versionnage des schémas, et par conséquent celui de la documentation qui décrit chaque modèle de données, les règles de gestion s'appuient sur les principes de la [Gestion sémantique de version 2.0.0](https://semver.org/lang/fr/)

Étant donné un numéro de version **majeur.mineur.correctif**, il faut incrémenter :

* le numéro de version **majeur** quand il y a des changements non rétrocompatibles,
* le numéro de version **mineur** quand il y a des changements rétrocompatibles,
* le numéro de version de **correctif** quand il y a des corrections d’anomalies rétrocompatibles.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://opendatafrance.gitbook.io/evolution-du-socle-commun-des-donnees-locales/guide-elaboration/recommandations-relatives-aux-schemas-de-validation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.