search

babel / website

:globe_with_meridians: The Babel documentation website
https://babeljs.io/docs/en/index.html
MIT License
752 stars 1.31k forks source link

Promote core-js/stable instead of @babel/polyfill #2240

Open dilyanpalauzov opened 4 years ago

dilyanpalauzov commented 4 years ago

https://babeljs.io/docs/en/ says “Babel is a JavaScript compiler: Polyfill features that are missing in your target environment (through @babel/polyfill)”

https://babeljs.io/docs/en/usage says “Running these commands to install the packages: npm install --save @babel/polyfill… Polyfill: As of Babel 7.4.0, this package has been deprecated in favor of directly including core-js/stable (to polyfill ECMAScript features) and regenerator-runtime/runtime (needed to use transpiled generator functions)”

https://babeljs.io/docs/en/babel-polyfill repeats “As of Babel 7.4.0, this package has been deprecated in favor of directly including core-js/stable (to polyfill ECMAScript features) and regenerator-runtime/runtime (needed to use transpiled generator functions)”

• Change https://babeljs.io/docs/en/ to state “… (through core-js/stable)”

• Update the documentation to state first how to poliyfill with core-js and then how for old Babel to use @babel/polyfill.

babel-bot commented 4 years ago

Hey @dilyanpalauzov! We really appreciate you taking the time to report an issue. The collaborators on this project attempt to help as many people as possible, but we're a limited number of volunteers, so it's possible this won't be addressed swiftly.

If you need any help, or just have general Babel or JavaScript questions, we have a vibrant Slack community that typically always has someone willing to help. You can sign-up here for an invite.

JLHwung commented 4 years ago

@dilyanpalauzov Thanks for the report, yeah we should have maintained consistency everywhere. Can you draft a PR?

dilyanpalauzov commented 4 years ago

No, I do not understand how it works.