Skip to content

docs: add v8 migration entries for inclusive terminology renames#3184

Open
stuckvgn wants to merge 1 commit intobabel:mainfrom
stuckvgn:docs/v8-migration-inclusive-terminology
Open

docs: add v8 migration entries for inclusive terminology renames#3184
stuckvgn wants to merge 1 commit intobabel:mainfrom
stuckvgn:docs/v8-migration-inclusive-terminology

Conversation

@stuckvgn
Copy link
Copy Markdown

Summary

Documents the option renames introduced in babel/babel#17830:

  • @babel/plugin-external-helpers: whitelist option renamed to allowlist (in v8-migration.md)
  • @babel/template: placeholderWhitelist option renamed to placeholderAllowlist (in v8-migration-api.md)
  • @babel/traverse: blacklist visitor option renamed to denylist (in v8-migration-api.md)

All entries document the cross-version compatibility path (passing both old and new option names simultaneously).

Requested by @nicolo-ribaudo in babel/babel#17830 (review).

@netlify
Copy link
Copy Markdown

netlify bot commented Feb 28, 2026

👷 Deploy request for babel-next pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 67f521f

@netlify
Copy link
Copy Markdown

netlify bot commented Feb 28, 2026

Deploy Preview for babel ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 67f521f
🔍 Latest deploy log https://app.netlify.com/projects/babel/deploys/69b7ce6da558b40008164b42
😎 Deploy Preview https://deploy-preview-3184--babel.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@stuckvgn
Copy link
Copy Markdown
Author

Closing this PR — on reflection, this change may not be the right fit for this project. Thanks for your time!

@stuckvgn stuckvgn closed this Mar 14, 2026
@stuckvgn
Copy link
Copy Markdown
Author

Reopening — this is the companion docs PR to babel/babel#17830.

@stuckvgn stuckvgn reopened this Mar 14, 2026
Document the option renames introduced in babel/babel#17830:
- @babel/plugin-external-helpers: whitelist -> allowlist
- @babel/template: placeholderWhitelist -> placeholderAllowlist
- @babel/traverse: blacklist -> denylist

All renames support cross-version compatibility by accepting both
old and new option names simultaneously.
@stuckvgn stuckvgn force-pushed the docs/v8-migration-inclusive-terminology branch from 2781351 to 67f521f Compare March 16, 2026 09:33
@stuckvgn
Copy link
Copy Markdown
Author

Hi! Flagging that the companion implementation PR (babel/babel#17830) merged on April 11. The docs changes here reflect what's now in the codebase. Would appreciate a look when you get a chance.

Copy link
Copy Markdown
Contributor

@JLHwung JLHwung left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants