Guides

Written against measurements rather than against the announcement post. Every number in these pages is produced by the converter itself at build time, from payloads you can load and check.

• What is TOON? The format explained

  A working understanding of Token-Oriented Object Notation in about five minutes, including the parts the announcement posts leave out.

• When not to use TOON

  The format has one mechanism, and when that mechanism does not apply, neither do the savings. Here is how to recognise the cases before you rewrite a pipeline.

• TOON vs JSON, measured against the right baseline

  The headline number depends almost entirely on which JSON you compare against — and most published comparisons pick the flattering one.

• Using TOON in an LLM prompt

  Converting the data is the easy half. The decisions that determine whether it works are about the prompt around it.

• How this tool measures, and what it cannot

  A number is only worth quoting if you can see how it was produced. Here is the whole method, including the parts that weaken the claims.