FAIR Data Cookbook

Contents

FAIR Data Cookbook#

Welcome to the FAIR Data Cookbook! This collection of “recipes” provides practical, step-by-step guides for implementing the FAIR Data JSON Schema vocabularies in your own data products.

Each recipe addresses a specific challenge—from basic identification to complex semantic mapping—and includes working examples you can copy and adapt.

🏷️ Coded Values & Enums

Learn how to evolve from standard JSON Schema enum validation to rich, multilingual FAIR coded values.

Coded Values: From Enums to FAIR Domains
🌊 The Variable Cascade

Understand how to implement the DDI Variable Cascade (Instance -> Represented -> Conceptual) using internal references.

The Variable Cascade Master Guide
📦 Data Products & Relations

How to describe complex data products, including hierarchical files and join relationships between tables.

Data Products & Dataset Relationships
🏗️ Extension Mechanisms

A deep dive into the four ways to extend JSON Schema: Annotations, Vocabularies, Dialects, and Refinements.

Extension Mechanisms

All Recipes#


[!TIP] Each recipe includes a “How-to” section with actionable steps. If you’re looking for the raw JSON schema examples, check the examples/ folder in the source repository.