968298 - https://addons.mozilla.org/en-US/developers/ should link directly to https://developer.mozilla.org/Add-ons for add-ons documentation

Status: VERIFIED FIXED

(addons.mozilla.org Graveyard :: Developer Pages, defect)

Description

[Will Bamberg [:wbamberg]]

Currently the page at https://addons.mozilla.org/en-US/developers/ has a collection of links under "How-to Library" and "API & Language Reference" that go to other pages on AMO that collate links that mostly go to old XUL reference and tutorial pages, such as:

https://addons.mozilla.org/en-US/developers/docs/how-to/getting-started

There's no mention of the SDK in these collections of links. Someone visiting this page to try to find documentation on Firefox add-on development might easily never learn of the existence of the SDK.

This sits quite oddly with the statement in 
https://developer.mozilla.org/Add-ons that "Overlay extensions are 
mostly obsolete now".

It's obviously hard to maintain these pages. Rather than try to maintain the add-ons documentation that is on AMO, it might be better to minimise the documentation on AMO and send people to MDN as soon as possible. We could just have a link in the "Learn and explore" box that goes directly to https://developer.mozilla.org/Add-ons. We'd need other, similar, links to the JavaScript and CSS homepages on MDN.

This also applies to the links in the "Documentation" menu in the Developer Hub.

Comment 2

[Kris Maglione [:kmag]]

We had a brief discussion on this and decided that we should make the following near-term changes:

• Remove the 'Learn & Explore' box, and all linked pages, entirely, and expand the 'Create & Connect' in its place.
• Remove the 'Add-on Packager' link from the 'Create & Connect', and rename the box as appropriate.
• Keep graphics and styling of the 'Firefox Add-ons Made Easy', but change the button to point to the MDN add-ons landing page, and change the title, copy, and button text as appropriate.
• Remove the currently linked Builder page entirely.

It's currently on me to create a proof-of-concept. UX input may be necessary before it can go live.

Comment 3

[Mathieu Agopian [:magopian]]

PR: https://github.com/mozilla/olympia/pull/435
Fixed in: https://github.com/mozilla/olympia/commit/3b6be9397d19aac34ccb4ac9b2506279a851cd8a

Thanks Kris!

Comment 4

[Madalin Cotetiu]

Verified as fixed in FF36(Win7) based on instructions from comment 2.
Closing bug.