babel / babel/website

Improve visibility of `useBuiltIns: "entry"` on `@babel/polyfill` documentation

Open
#1,927 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
777
Forks
1.4k
Avg merge
16h 45m
Merged PRs (30d)
3

Description

The [docs for `@babel/polyfill`](https://babeljs.io/docs/en/babel-polyfill) have some easily copy-paste-able lines that show how to directly import `@babel/polyfill`, but to get to the explanation of how to pass `useBuiltIns: "entry"`, you have to click to another page.

Anecdotally, some people might be using `@babel/polyfill` directly without `useBuiltIns`, which is unfortunate, as it significantly increases bundle size.

I'm wondering, would it make sense to put the full explanation about how to use the `useBuiltIns: "entry"` option on the `@babel/polyfill` page, to reduce the risk that people will forget to include it?

(The best solution in terms of code size would be to tell everyone to use the `"usage"` option--is there a particular reason that's still experimental?)

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the @babel/polyfill documentation page linked in the issue and follow its current link to the useBuiltIns: "entry" explanation. Review how the option is presented and whether the experimental "usage" question affects scope. Done means the relevant guidance is visible where users copy the direct import instructions and clearly explains the bundle-size implications.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.