1208966 - Mozilla Apps Manifest doc is partially mixed with W3C Manifest

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: Apps, defect, P1)

Description

[Jean-Yves Perrier [:teoli]]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

I'm creating this bug to stop polluting bug 997779.

Context: 
* The https://developer.mozilla.org/en-US/Apps/Build/Manifest page state in the Specification box that the spec for it is the W3C manifest, which is wrong.
* The fact that this page describe the Mozilla manifest format, and the relations for it, is not clear.

First sketch of a plan:
* Remove the link to W3C manifest document from the Specifications section. State there that this is not standard
* Add the non-standard banner to the page
* Update the notes in the introduction:
** remove the Open Web Apps mentions (this is only for Firefox OS and Firefox Apps, not in general)
** add a note explaining the use cases of Mozilla Manifest and W3C Manifest to make it clear for the reader
* Find a place to document W3C manifest, so that work there can start.

Chris, I don't know if you have followed the discussion in the bug, but, as you know much better this area than me, what do you think of this plan?

Comment 1

[Chris Mills [:cmills]]

Ok, I've sorted this out:

https://developer.mozilla.org/en-US/Apps/Build/Manifest

I think your plan was perfect, J-Y. I've done everything that you've asked for, apart from working out a place to document the W3C manifest. I've asked Joe from Google if he is intending to work on this soon — it was him that started off all this confusion, by adding the spec/compat detail to the FxOS page. I've also told him that this page is for the proprietary FxOS manifest format, just to make it clear!

Comment 2

[Marcos Caceres [:marcosc]]

Excellent, thank you!

Comment 3

[Chris Mills [:cmills]]

You're welcome!

Joe responded, saying that documenting the manifest spec is not on his immediate list of work. So I'll put it into our Q4 priority list and see if it lands anywhere.