babel / babel/website

@babel/preset-env

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

Description

https://babeljs.io/docs/en/babel-preset-env#how-does-it-work mentions:

> We leverage these data sources to maintain [mappings of which version](https://github.com/babel/babel/blob/master/packages/babel-compat-data/data/plugins.json) of our supported target environments gained support of a JavaScript syntax or browser feature, as well as a mapping of those syntaxes and features to Babel transform plugins and core-js polyfills.

If I understood it correctly, that text is somewhat misleading. The [mappings of which version](https://github.com/babel/babel/blob/master/packages/babel-compat-data/data/plugins.json) part only lists plugins that will _transform_ the code. It is written like it is a complete list of of all Javascript and syntax features to certain browser versions.

Would it not be more clear to somehow re-write the text so that the link to `plugins.json` is just used for _transpilation_ i.e. _Babel transform plugins_ (which I think it is?) and then for the polyfill part with core-js separately (with another link if there is one for those mappings?)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.