The entity tag carries the body variant, not just the schema version
A missing variant in the tag was a live cross-repo cache bug: a client holding the plain body asked for the annotated one, was told it was unchanged, and went on serving a document with every title and description missing.
The rule
Normative: this is the rule
- The entity tag for a workflow schema is the quoted schema version for the plain document, and the quoted schema version plus a variant marker for the annotated one.
- Any request argument that changes the body must join the tag the same way: two documents that differ must never share a tag, whatever else varies on them.
Rule identifiers are permanent and are never renumbered. Each implementation publishes its own standing against these rules; this specification does not.spec 1.0-draft · META-6 · changed in spec 1.0