Guides

Short, opinionated explanations of the formats we work with every day. Each guide includes runnable examples and links to the relevant tool so you can try things as you read.

Basics

Troubleshooting

Comparison

  • JSON vs YAML: When to Use Which Format

    JSON and YAML solve overlapping problems but optimise for different users. This guide compares their syntax, strengths, and failure modes so you can pick the right one without regret.

  • JSON vs XML: A Practical Comparison in 2026

    XML has not gone away. It has moved to specific niches where its document model fits. This guide covers when each format is the right answer today, not the one it was in 2005.

Format guide

Strategy