835574 - Point the "API Reference" link in the Dev Hub header to the MDN apps API reference page

Status: RESOLVED FIXED

(Marketplace Graveyard :: Developer Pages, defect)

Description

[Michael Morgan [:morgamic]]

We need:
1. global nav link from devhub to MDN page for webAPIs
2. destination page on MDN that lists all APIs (see PRD)

Goal is to make API docs way more discoverable for developers since this is major area of focus for developers.

Comment 1

[Daniel Buchner [:dbuc]]

Adding sheppy for status check on the new page we'll be linking to from the top-nav on Dev Hub.

Comment 2

[Fred Wenzel [:wenzel]]

Assigning this to Edna, but we'll need the target page before we can point to it in production.

Comment 3

[Daniel Buchner [:dbuc]]

Remove all the "Docs & APIs" sections from each of the three sections Design, Code, Publish, and replace them with a link to the corresponding section on the new API page here: https://developer.mozilla.org/en-US/docs/Apps/Reference

Each link should read "____ Reference", wherein the blank is the section name it pertains to:

https://developer.mozilla.org/en-US/docs/Apps/Reference#Design
https://developer.mozilla.org/en-US/docs/Apps/Reference#Code
https://developer.mozilla.org/en-US/docs/Apps/Reference#Publish

Comment 4

[Daniel Buchner [:dbuc]]

This section should have been "Build", not "Code", sorry for the typo --> https://developer.mozilla.org/en-US/docs/Apps/Reference#Build

Comment 5

[Fred Wenzel [:wenzel]]

More duplicates: The top nav link is in bug 839662. Fixing possible inconsistencies in the subcategories will happen in bug 839665, bug 839666, bug 839667.

Comment 6

[Daniel Buchner [:dbuc]]

This is page we should be pointing the "API Reference" global Dev Hub nav link to: https://developer.mozilla.org/en-US/docs/Apps/Reference

What is currently on MDN /Apps does not fulfill the requirements generated by our developers and subsequently described in the PRD. Doc writers will update this page with the few items requested per Fred's comments in bug 838831.

Comment 7

[Fred Wenzel [:wenzel]]

Still a dupe, sorry. Let's figure out the target URL today, then land it.

Comment 8

[Daniel Buchner [:dbuc]]

I am reopening this as it has been lost in the shuffle after being dup'd into that general IA bug, it was never completed, and we *still* don't have our "API Reference" link pointed to the actual reference doc on prod: https://developer.mozilla.org/en-US/docs/Apps/Reference. This is far more important than any of the design and polish changes tweaks we'll do on Monday - I am suggesting we do a push today to account for it.

I will get with Wil and figure out push scheduling.

Comment 9

[Fred Wenzel [:wenzel]]

Oh yeah, sorry that happened. So you want to point to the .../Reference link instead of to .../Apps? Okay I can submit a pull request for that.

Comment 10

[Fred Wenzel [:wenzel]]

Attachment: Pointer to Github pull request: https://github.com/mozilla/zamboni/pull/622

Pointer to Github pull-request

Comment 11

[Fred Wenzel [:wenzel]]

Pull request landed on master: https://github.com/mozilla/zamboni/commit/8365ed8

The Marketplace team will cherry-pick it to prod today.