Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Non-standard disclaimer is incorrectly discouraging #9774

Open
nora-soderlund opened this issue Oct 1, 2023 · 4 comments · May be fixed by mdn/content#38588
Open

Non-standard disclaimer is incorrectly discouraging #9774

nora-soderlund opened this issue Oct 1, 2023 · 4 comments · May be fixed by mdn/content#38588
Assignees
@caugner
Labels
effort: small This task is a small effort. nit Minor issue or trivial bug p2 We want to address this but may have other higher priority items.

Comments

@nora-soderlund
Copy link

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
@nora-soderlund nora-soderlund added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Oct 1, 2023
@caugner caugner transferred this issue from mdn/content Oct 6, 2023
@caugner caugner added p2 We want to address this but may have other higher priority items. effort: small This task is a small effort. nit Minor issue or trivial bug and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Oct 6, 2023
@Rumyra
Copy link
Contributor

Rumyra commented Oct 6, 2023

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
Copy link
Contributor

caugner commented Oct 6, 2023

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

yari/kumascript/macros/Non-standard_Header.ejs

Lines 14 to 22 in cff107f

var str_long = mdn.localString({
"en-US": "This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.",
"es": "Esta característica no es parte de los estándares. No la uses en sitios Web en producción: no funcionará para todos los usuarios. Podrían haber también incompatibilidades considerables entre distintas implementaciones y el comportamiento podría cambiar en el futuro.",
"fr": "Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.",
"ja": "この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。",
"ko": "이 기능은 비표준이므로 실제 프로덕션에서 사용하지 마세요. 모든 사용자 환경에서 작동하지 않을 수 도 있으며, 미래에 호환성 문제가 생길 수 있습니다.",
"ru": "Эта возможность не является стандартной и стандартизировать её пока никто не собирается. Не используйте её на сайтах, смотрящих во внешний мир: она будет работать не у всех пользователей. Также могут присутствовать большие несовместимости между реализациями и её поведение может в будущем измениться.",
"zh-CN": "该特性是非标准的，请尽量不要在生产环境中使用它！"
});

@yin1999 yin1999 mentioned this issue Nov 3, 2023
Open
@Rumyra
Copy link
Contributor

Rumyra commented Nov 27, 2023

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.

@github-actions github-actions bot added the idle label Jan 24, 2024
@caugner caugner self-assigned this May 20, 2024
@caugner caugner mentioned this issue May 20, 2024
Closed
@github-actions github-actions bot removed the idle label May 20, 2024
@github-actions github-actions bot added the idle label Jun 20, 2024
caugner added a commit to mdn/content that referenced this issue Mar 12, 2025
@caugner
Update non-standard disclaimer
bbbbe7f 
Port from mdn/yari#11163.

Fixes mdn/yari#9774.
@caugner caugner linked a pull request Mar 12, 2025 that will close this issue
Open
@hamishwillee
Copy link
Contributor

hamishwillee commented Mar 13, 2025 •
edited
Loading

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

I have proposed an alternative text since I think this still has the problems outlined in the issue mdn/content#38588 (comment)

@github-actions github-actions bot removed the idle label Mar 13, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@caugner caugner

Labels
effort: small This task is a small effort. nit Minor issue or trivial bug p2 We want to address this but may have other higher priority items.
Projects
None yet
Milestone
No milestone
4 participants
@Rumyra @caugner @hamishwillee @nora-soderlund