webauthn icon indicating copy to clipboard operation
webauthn copied to clipboard

Dependencies section is out of date and duplicates terms index

Open emlun opened this issue 3 years ago • 1 comments

§3. Dependencies states that

This specification relies on several other underlying specifications, listed below and in Terms defined by reference.

It also states, for example:

HTML The concepts of browsing context, origin, opaque origin, tuple origin, relevant settings object, and is a registrable domain suffix of or is equal to are defined in [HTML].

...but the Terms defined by reference section lists many more terms for most of these dependencies.

Should we attempt to keep these sections in sync, or should we move most details out of §3. Dependencies? The Terms defined by reference section is generated automatically and should always cover all references to other Bikeshed-covered specs, but the Dependencies section needs to be maintained manually. Specs outside of Bikeshed coverage (CBOR, CDDL, etc.) would still need to be listed manually in §3 Dependencies, though.

emlun avatar Sep 08 '22 13:09 emlun

@ve7jtb please see if this is still relevant

nadalin avatar Aug 30 '23 18:08 nadalin