search

babel / website

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

Better documentation and explanation of useBuiltIns in @babel/preset-env #2006

Open babel-bot opened 5 years ago

babel-bot commented 5 years ago

Original issue submitted by @modestotech in https://github.com/babel/babel/issues/9185

Feature Request

Is your feature request related to a problem? Please describe. I'm having troubles wrapping my head the implications of the useBuiltIns option in@babel/preset-env. I've read the documentation and can understand the concepts, but the implications of the useBuiltIns options remain vague to me.

I used the entry option successfully but then wanted to use usage as it seems to me that it makes more sense to import the polyfills when needed. I had some troubles with the implementation but got help from the community here and here. The solutions are not obvious to me.

Describe the solution you'd like

I would like a better documentation of what each option does (in terms comprehensible to your average developer), and why both options exist. Is one of them recommended, or what decides when one should be chosen over another?

babel-bot commented 5 years ago

Hey @babel-bot! 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.