The two schema variants are cached on deliberately different terms
The annotated document reattaches translated text from live plugins, so a shared copy would serve one interface language's annotations to a reader in another.
The rule
Normative: this is the rule
- The plain workflow schema document is publicly cacheable for at most 60 seconds.
- The annotated document is served
no-cache. - A schema response varies by the argument selecting the variant on every path, including the one that adds nothing else, and varies by interface language only when annotated.
- A response is invalidated when the workflow it describes changes, and by nothing broader.
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-8 · changed in spec 1.0