JSONGuide
Using JSON in Application Design Without Making a Mess
A tested guide to where JSON belongs in an application: columns, API shapes, settings, events, drift and patches, with measured costs in PostgreSQL.
17 min read
Topic
Data Modeling
Schemas that age well: keys, normalization, constraints and the shortcuts you will regret in a year.
JSON
Versioning a JSON Schema Without Breaking Consumers
Which schema changes break old producers and old consumers: a tested compatibility matrix, open versus closed objects, version numbers and a CI check.
8 min read
JSON
Generating a JSON Schema From Sample Data and Fixing It
Draft a JSON Schema from sample documents with genson, see what it infers and what it misses, and turn the draft into a contract with DuckDB as a cross-check.
7 min read
JSON
Reusing Definitions With ref in JSON Schema Documents
Reuse schema pieces with $ref and $defs: local pointers, references between files by $id, recursive trees, and resolver and draft traps in Python and Node.
7 min read
JSON
Using JSON Schema Enums Formats and Patterns Correctly
Where Python and Node disagree on JSON Schema formats and patterns: email, uri, hostname, digits, trailing newlines, plus exact enum and const behavior.
6 min read
JSON
Validating Arrays and Nested Objects With JSON Schema
Validate arrays of objects, tuples and deep nesting with JSON Schema: items, prefixItems, contains, uniqueItems and error paths, tested in Python.
6 min read
JSON
Required Fields and Optional Fields in JSON Schema
How required, null, empty strings and defaults differ in JSON Schema, with test results for dependentRequired and if-then rules for conditional fields.
6 min read
JSON
Writing Your First JSON Schema From a Real Document
Build a JSON Schema from a user profile document one keyword at a time, run it in Python after each step, and catch typos that a validator ignores silently.
7 min read
JSONGuide
Validating JSON With JSON Schema in Real Team Projects
A working guide to JSON Schema: write a schema, run it in Python and Node, handle formats, refs and versions, and check JSON stored in a database.
19 min read
XMLGuide
Choosing XML Over the Alternatives or Not for a New Project
A decision guide for XML versus JSON, YAML, CSV and Protocol Buffers, with measured sizes and parse times, six scenarios and a migration path.
16 min read
XML
Using XML Namespaces for Extensions Without the Chaos
Let partners add their own data to your XML format safely by giving each extension its own namespace, with a reader that ignores what it does not own.
6 min read
XML
Mixed Content in XML and Why It Hurts Parsing and Mapping
Text and elements side by side look natural in documents and break data models. How ElementTree and lxml expose text and tail, and what to do instead.
6 min read
Get new articles by email
We send one email when a new article is published. No spam.