search

mdn / yari

The platform code behind MDN Web Docs
Mozilla Public License 2.0
1.17k stars 498 forks source link

Non-standard disclaimer is incorrectly discouraging #9774

Open nora-soderlund opened 10 months ago

nora-soderlund commented 10 months ago

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Element/gesturestart_event

What specific section or headline is this issue about?

Non-standard disclaimer

What information was incorrect, unhelpful, or incomplete?

The non-standard disclaimer makes a valid point, but also the wrong discouragement; designing a website to be exactly the same for all browsers, which may have different default behavior, has never been a valid stance.

What did you expect to see?

Do not use it on production sites facing the Web: it will not work for every user.

It will not work for every user, but that doesn't mean it should not be used in production sites. The disclaimer should be updated to be more informative than discouraging.

Do you have any supporting links, references, or citations?

An example of where this event has a real valid production use-case is with Safari browsers, in preventing the default browser behaviour, see https://stackoverflow.com/a/39711930

Do you have anything more you want to share?

No response

Rumyra commented 10 months ago

Thanks for raising the issue @nora-soderlund - this is an inserted banner into pages, so we're moving to the platform repository and will discuss further on the wording change

caugner commented 10 months ago

Thanks @Rumyra. The text is coming from the Non_standard_Header macro:

https://github.com/mdn/yari/blob/cff107f7cf7cd9fca332165066b1d44a27dddd3e/kumascript/macros/Non-standard_Header.ejs#L14-L22

Rumyra commented 8 months ago

Suggestion to modify the text to

We do not reccomend using this on production sites facing the Web: as it will not work for every user.