From 42460f063ab883776111b2bc28612b0c56f1cbab Mon Sep 17 00:00:00 2001 From: geoffreyaldebert Date: Wed, 7 Feb 2024 11:38:03 +0100 Subject: [PATCH] doc: readme --- README.md | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index cefc411..2ded76a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,35 @@ -# Readme of datapackage +# Template de départ pour Data Package -Datapackage +Ce dépôt contient les fichiers nécessaires pour démarrer la création d'un dépôt pour un schéma [Data Package](https://specs.frictionlessdata.io/data-package/). +## Utiliser ce template + +- Si vous créez votre dépôt sur GitHub, il vous suffit d'appuyer sur le bouton vert "Use this template". Consultez [la documentation](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template) pour plus d'infos ; +- Si votre projet sera hébergé ailleurs (par exemple Gitlab), vous pouvez cloner ce répertoire ou télécharger les fichiers correspondants. Utilisez le bouton "Clone or download". + +## Fichiers disponibles + +Ce dépôt contient un ensemble de fichiers utiles pour un dépôt d'un schéma [Data Package](https://specs.frictionlessdata.io/data-package/). + +- [`CHANGELOG.md`](CHANGELOG.md) contient la liste des changements entre les différentes versions de votre schéma ; +- [`LICENSE.md`](LICENSE.md) est le fichier de licence du dépôt. Nous recommandons d'utiliser la [Licence Ouverte](https://www.etalab.gouv.fr/licence-ouverte-open-licence), cette licence est recommandée par l'administration française pour le partage de données et de documents ; +- [`README.md`](README.md) est le fichier que vous lisez actuellement. À terme, il devra présenter votre schéma ; +- [`requirements.txt`](requirements.txt) liste les dépendances Python nécessaires pour effectuer des tests en intégration continue sur votre dépôt ; +- [`datapackage.json`](datapackage.json) est le schéma au format Data Package qui fait référence à deux tables contenues dans les dossiers `table1` et `table2`. + +### Intégration continue + +Ce dépôt est configuré pour utiliser de l'intégration continue, si vous utilisez GitHub. À chaque commit, une suite de tests sera lancée via [GitHub Actions](https://github.com/features/actions) afin de vérifier : + +- que votre schéma est valide à la spécification Data Package ; +- que vos fichiers d'exemples sont conformes au schéma. + +Si vous n'utilisez pas GitHub, vous pouvez lancer ces tests sur votre machine ou sur un autre service d'intégration continue comme Gitlab CI, Jenkins, Circle CI, Travis etc. Consultez la configuration utilisée dans [`.github/workflows/test.yml`](.github/workflows/test.yml). + + +## Documentation + +Pour vous aider dans la construction de votre dépôt, nous vous recommandons de vous référer à : + +- [Le guide à destination des producteurs de schéma](https://guides.data.gouv.fr/guides-open-data/guide-qualite) +- [La documentation de schema.data.gouv.fr](https://schema.data.gouv.fr) \ No newline at end of file