CoffeeJSON documentation

The normative specification, the transport binding, and the guides that apply them. Where a guide, an example, or the JSON Schema disagrees with the specification prose, the prose wins.

Specification

Read in order; each chapter is self-contained enough to cite on its own.

  1. Overview — scope, the three entities, design principles, and the conformance language (MUST / SHOULD / MAY).
  2. Document envelope — the coffeejson version marker plus the beans, recipes, and tastings collections.
  3. Recipe — the brew-parameters entity: Measurement, Gear, Grind, and Step.
  4. Bean — the coffee-identity entity: Origin, OriginItem, process, varietals, and roast attributes.
  5. Tasting — how a brewed cup turned out: attributed impression and instrument reading, kept apart.
  6. Vocabularies & registries — every controlled vocabulary, the two open registries (gear, varietals), and the fallback rules.
  7. Versioning & conformance — versioning, media type, conformance targets, registry governance.

Transport binding

Guides (non-normative)

Schema