Guide

Short, task-shaped pages. Every command in them was run against a real build, and the output you see is the output it printed.

• Byte-for-byte, explained – what yqr preserves, why the identity filter is a useful test, and when you want --normalize instead.
• Editing Kubernetes manifests – bumping image tags and replica counts so the diff is one line.
• Validating YAML – checking a file is still correct after an edit, and catching the duplicate keys that silently eat your data.
• Enumerating mappings – reporting what each value is about, with to_entries, when iterating throws the names away.
• Coming to yqr from jq – which jq idioms work unchanged, the one operator that means something else, and where the two languages stop.

If you are arriving from another tool, how yqr compares to yq is probably the faster orientation.