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

Update docs to include the description of what `legacy` actually does for `@babel/plugin-proposal-decorators` #2741

Open catamphetamine opened 6 years ago

catamphetamine commented 6 years ago

The docs are very vague about legacy flag on @babel/plugin-proposal-decorators. They don't tell which one should a developer choose: legacy: false or legacy: true. There is no description of the actual difference in behaviour whether the flag is enabled or disabled. https://babeljs.io/docs/en/next/babel-plugin-proposal-decorators.html

babel-bot commented 6 years ago

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

nicolo-ribaudo commented 6 years ago

As for now, only legacy: true is supported so it doesn't really make sense to explain the difference. We will publish a detailed blog post about this when we will support legacy: false.

babel-bot commented 1 year ago

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