-
-
Notifications
You must be signed in to change notification settings - Fork 1.3k
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.
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
The section in the docs on Polyfills is unclear #2857
Comments
Hey @Richardinho! We really appreciate you taking the time to report an issue. The collaborators If you need any help, or just have general Babel or JavaScript questions, we have a vibrant Slack |
IMHO, the section on Polyfills in the documentation - https://babeljs.io/docs/usage - is not very clear.
The section starts off saying:
Firstly, the deprecated package itself is not stated, which is a bit confusing (although I assume it's @babel/polyfill).
Secondly, it's not clear whether or not we're supposed to ignore this section entirely because of the deprecation warning.
The fact that the section later includes instructions on how to install
@babel/polyfill
makes me think that these are old instructions and so we should ignore them, but I'm not sure because it also includes instructions for using core-js.After these instructions we have:
So what is this saying? all we need to do is import core-js and all the previous instructions are irrelevant? Or we need to follow the preceding instructions and install core-js?
Then further down the page, in the summary, it mentions @babel/polyfill again as if it's not deprecated!
It seems to me that this section should be split up into two sections:
Or perhaps just say that @babel/polyfill is deprecated and only have the second section.
The text was updated successfully, but these errors were encountered: