Fix API overview sidebars

[wbamberg]

This PR fixes all the "web-api-overview" pages under Web/API which erroneously use "APIRef" instead of "DefaultAPISidebar".

Except for https://developer.mozilla.org/en-US/docs/Web/API/Constraint_validation.

[github-actions]

Preview URLs (6 pages)

• /en-US/docs/Web/API/Keyboard_API
• /en-US/docs/Web/API/Media_Capture_and_Streams_API
• /en-US/docs/Web/API/Push_API
• /en-US/docs/Web/API/Reporting_API
• /en-US/docs/Web/API/Sensor_APIs
• /en-US/docs/Web/API/Web_Locks_API

Flaws (6)

Note! 5 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/Media_Capture_and_Streams_API
Title: Media Capture and Streams API (Media Stream)
Flaw count: 6

• macros:
  • /en-US/docs/Web/API/MediaDeviceKind does not exist
  • /en-US/docs/Web/API/MediaTrackCapabilities does not exist
  • /en-US/docs/Web/API/NavigatorUserMedia does not exist
  • /en-US/docs/Web/API/NavigatorUserMediaError does not exist
• bad_bcd_links:
  • no explanation!
  • no explanation!

[wbamberg]

I started mdn/mdn-community#291 for Constraint Validation.

[bsmth]

Aside from the Push API page, the preview pages look better. I had to look up the macro to find out what it does, but I could still do with hints when to use this over other. Do we need to add anything to the sidebar docs for this?

The Prettier formatting looks good.

[wbamberg]

Aside from the Push API page, the preview pages look better. I had to look up the macro to find out what it does, but I could still do with hints when to use this over other.

API overview pages (that is, pages with page-type: web-api-overview) should use {{DefaultAPISidebar}}, and all other pages should use {{APIRef}}.

A long time ago I wrote up a kind of guide to them: https://discourse.mozilla.org/t/defaultapisidebar-apiref-and-groupdata/40210 but I don't know if there is anything comparable on MDN.

Do we need to add anything to the sidebar docs for this?

Those docs are hopelessly inadequate, so probably. Sidebars for Web/API are ridiculously complicated. Ruth and I proposed a much simpler solution in openwebdocs/project#76 but it doesn't seem to be going anywhere at the moment.

(I suppose, rather than write more meta-docs, I'd like to put time into simplifying our sidebar system. Which sidebar to use for what page shouldn't even be an authorial choice.)

[bsmth]

Thank you for the explanation!

[bsmth]

Looks good, thank you! I'm happy to merge when you are.