Self-Describing API / Payload Verbosity

Kind: tension

Record: tension:payload-verbosity-self-describing-api

Canonical: Schema

"self-describing-api" (declarative-core layer) is traded against "Payload Verbosity" (declarative-core layer) — a principle cannot be scope-separated from a quality, metric, or cost it competes with; resolve by measuring "Payload Verbosity" and choosing an explicit operating point.

Listed in Tensions, after Self-Describing Architecture / Metadata Drift and before Self-Describing Structures / Size Overhead.

In tension with

• Self-Describing API
• Payload Verbosity

Mechanism

• irreducible-tradeoff

Linked from

• Metadata / Self-Description / Declarative Systems
• Resolution mechanisms