Fairspec

Un format d'échange de données pour décrire des jeux de données — ce qu'un jeu de données contient, la forme de ses tables, qui l'a produit et sous quelle licence il peut être réutilisé. Un descripteur est un simple document JSON : il peut donc être écrit à la main, généré par un pipeline, validé en CI et lu par un outil qui n'a jamais entendu parler de Fairspec.

Les jeux de données sont publiés en permanence et décrits de façon incohérente. Les métadonnées qui les rendraient réutilisables — types de colonnes, unités, provenance, licence — vivent en général dans un README, un article ou la mémoire de quelqu'un. Les principes FAIR disent que les données doivent être faciles à trouver, accessibles, interopérables et réutilisables, mais des principes ne sont pas un format de fichier, et une machine ne peut pas agir sur un principe. Fairspec est délibérément compatible avec deux choses qui existent déjà plutôt que de les concurrencer : DataCite pour les métadonnées de citation, et JSON Schema pour la validation.

Nous écrivons la spécification et maintenons les implémentations de référence en TypeScript et en Python, ainsi que l'outillage qui les consomme. Écrire un standard signifie que les décisions de conception et les garanties de compatibilité sont à nous de bien faire.