docs/guides/leases.md:29-30 states that custom capability names must follow x-vendor.<vendor>.<cap> with "at least three dot-separated segments after the x-vendor. prefix". The implementation in packages/core/src/extensions.ts:12 defines VENDOR_EXTENSION_PATTERN = /^x-vendor(?:\.[a-z0-9_-]+){2,}$/, which requires at least two dot-separated segments after the prefix (so x-vendor.foo.bar and the canonical OTel key x-vendor.opentelemetry.tracecontext both validate). A reader following the docs would believe their two-segment vendor key was non-compliant when it is in fact accepted by the runtime, or — worse — would refuse to publish a perfectly valid name like x-vendor.opentelemetry.tracecontext because the docs say it needs another segment.
Fix prompt: edit docs/guides/leases.md:29-30 to say "at least two dot-separated segments after x-vendor." and add x-vendor.opentelemetry.tracecontext to the inline examples as the canonical motivating case. Cross-check docs/guides/vendor-extensions.md (it already states the rule correctly per packages/core/src/extensions.ts) so the two guides agree, and link the leases guide to the vendor-extensions guide for the single source of truth on namespace rules.
docs/guides/leases.md:29-30states that custom capability names must followx-vendor.<vendor>.<cap>with "at least three dot-separated segments after thex-vendor.prefix". The implementation inpackages/core/src/extensions.ts:12definesVENDOR_EXTENSION_PATTERN = /^x-vendor(?:\.[a-z0-9_-]+){2,}$/, which requires at least two dot-separated segments after the prefix (sox-vendor.foo.barand the canonical OTel keyx-vendor.opentelemetry.tracecontextboth validate). A reader following the docs would believe their two-segment vendor key was non-compliant when it is in fact accepted by the runtime, or — worse — would refuse to publish a perfectly valid name likex-vendor.opentelemetry.tracecontextbecause the docs say it needs another segment.Fix prompt: edit
docs/guides/leases.md:29-30to say "at least two dot-separated segments afterx-vendor." and addx-vendor.opentelemetry.tracecontextto the inline examples as the canonical motivating case. Cross-checkdocs/guides/vendor-extensions.md(it already states the rule correctly perpackages/core/src/extensions.ts) so the two guides agree, and link the leases guide to the vendor-extensions guide for the single source of truth on namespace rules.