November 28, 2025
Two truths, zero chill
JSON Schema Demystified: Dialects, Vocabularies and Metaschemas
Readers rage: 'Stop inventing words' as JSON rules go from simple to brain-bending
TLDR: An explainer demystifies the maze of JSON Schema terms and shows how rules about data can validate themselves. Commenters split between calling the spec overcomplicated and demanding stricter, simpler rules, with side drama over outdated versions and philosophical jabs about “one truth” instead of duplicated states.
JSON Schema—the rulebook for checking if your app’s data looks right—just got a plain-English explainer, and devs are cheering and jeering. The post promises to decode scary words like “metaschema,” “dialects,” and “vocabularies,” and shows how schemas are rules written in JSON (a popular text format for data) that can even validate themselves via a metaschema. But the comments? Pure theater. Some readers say the terminology is a power move to make normals feel dumb; others love the nerdy recursion. One standout meme: typo police catching “stirng” with spec-backed swagger.
Hot takes are flying. Adamzwasserman drops philosophy—“stop lying about where truth lives”—arguing tools should stop duplicating state. Afiori grumbles everyone’s stuck on ancient Draft 4 while the spec keeps marching. Boricj calls JSON Schema “too flexible,” great to write but painful to build tools around. Jopsen misses the simple days, claiming validators now feel like boss fights. Jhoechtl says the spec made an “open world” mistake; most teams just want strict rules: this message or bust. The vibe: half of devs want fewer buzzwords and a lock-tight rulebook, half want the flexibility and power. And everyone agrees: the lingo could chill.
Key Points
- •JSON Schema describes the shape and constraints of JSON data using rules for types, properties, and values.
- •Schemas are JSON documents; their structure can be described and validated by metaschemas.
- •A metaschema defines the meaning and allowed values of JSON Schema keywords and how they interact.
- •An excerpt of the JSON Schema draft 2020-12 metaschema illustrates constraints on the “type” and “properties” keywords, including use of $dynamicRef.
- •Validating schemas against the metaschema helps catch errors and serves as the formal specification for schema-processing tools.