search

mdn / pab

MDN Web Docs Product Advisory Board
26 stars 17 forks source link

Guielines for marking obsolete/experimental on MDN #62

Closed alispivak closed 5 years ago

alispivak commented 6 years ago

Propose guidelines/policy around contradictions in peer specs (specifically when to mark things obsolete/experimental), share for review with MDN team & PAB, add real examples in practice.

alispivak commented 6 years ago

Action item from MArch 2018 PAB meeting

chrisdavidmills commented 6 years ago

I have written a testcase — see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Attributes (search for inputMode). Do you think this explains the spec conflict appropriately?

If this seems OK, I will add guideance on dealing with such situations to

https://developer.mozilla.org/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions#Definitions

Along with guidelines on when items should be marked as obsolete/deprecated and experimental, which I think is basically covered anyway.

@patrickkettner , what do you think of this?

chrisdavidmills commented 6 years ago

See this guide:

https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Remove__Experimental__Macros

chrisdavidmills commented 5 years ago

OK, obsolete/deprecated/experimental are defined well in the following doc, along with what to do about a spec contradiction:

https://developer.mozilla.org/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions

Closing this now.