Web APIs breadcrumb navigation should place interfaces below APIs

[scottdotweb]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Document

What specific section or headline is this issue about?

No response

What information was incorrect, unhelpful, or incomplete?

The Document interface is a subset of the DOM API. However, both of them appear at the same level within the breadcrumb navigation:

• References > Web APIs > Document Object Model (DOM)
• References > Web APIs > Document

There's a link to the DOM section at the top of the left hand side navigation, but as soon as you scroll that it's no longer visible. Navigating from an interface to its parent API is common and this impedes that.

What did you expect to see?

The breadcrumb navigation should present the full path to interfaces, accurately conveying their relationship to their parent API. In the case of Document that would be:

• References > Web APIs > Document Object Model (DOM) > Document

This would allow the parent API to be reachable by a single click at all times.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

[Josh-Cena]

Hi, this is the architecture we've chosen: interfaces are siblings of API overviews, not subpages. The reason being, not all interfaces clearly belong to one API: Navigator, Window, Element, etc. often have properties that are defined by other specs, making the architecture extremely confusing if each interface has to belong to one interface.