On MDN we have docs for WebExtensions, the new cross-browser system for developing browser extensions. Currently these live at https://developer.mozilla.org/en-US/Add-ons/WebExtensions. This is in the “Add-ons zone”, and places the docs alongside docs that are clearly Mozilla-specific.
Actually, its real URL is https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/, so it’s explicitly in the “Mozilla” bit of the tree, but zones do some URL redirection for some reason.
We’ve recently decided to stop calling these things WebExtensions and start calling them just “Browser extensions”, which matches the name of the draft specification: https://browserext.github.io/browserext/.
We want to move the docs so the URLs match this name change. The current suggestion is to move them to https://developer.mozilla.org/en-US/Add-ons/Extensions, and there’s a PR already filed to update all the macros that hardcode the path: https://github.com/mdn/kumascript/pull/273.
But it’s also been suggested that we should move the docs from https://developer.mozilla.org/en-US/Add-ons/ (or more accurately, from https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/) out of the Mozilla-specific part of the tree, to reflect that this isn’t a Mozilla-specific technology, and to bring them more into the mainstream of the “MDN web docs”.
If we did this, then where should we move it to?
https://developer.mozilla.org/en-US/docs/Web/Extensions is one option, but it might confuse people into thinking that this technology is available to normal web pages
https://developer.mozilla.org/en-US/docs/Browser/Extensions is another, perhaps.
Or, we could just do the original move, into https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/. But I don’t really want to do that unless we are sure that’s a good long-term home.