Show guide pages in {{APIRef}} macro

[wbamberg]

Currently we show guide pages in the {{DefaultAPISidebar}} macro, but not in {{APIRef}}, It would be good to list guide pages in {{APIRef}} as well.

See also: mdn/content#13761 and https://discourse.mozilla.org/t/defaultapisidebar-apiref-and-groupdata/40210/12.

[caugner]

@wbamberg Are you still interested in this? If so, can you provide some concrete examples of pages using the APIRef sidebar and which Guide(s) you would hope to see in the sidebar? 🙏

[wbamberg]

Any page with APIRef (interfaces, methods, properties, events) ought to have a "group" in groupdata.json that represents the API it belongs to, and that group may list guides relevant to the API. Those guides should appear in the APIRef sidebar as well as the DefaultAPISidebar.

For example, the page for Request (and all of its subpages) ought to have a link to Using the Fetch API. As it is, people have to know they must click "Fetch API" at the top to get to a place where they can see a link to the guide.

It would be worth considering cases where there are lots of guides, and we occasionally have tutorials (https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API and https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API) so it might be better to collapse the "guides" and "tutorials" sections in APIRef sidebars.