babel / babel/website

Unclear documentation for babelrc option

Open
#2,054 5 comments 1 reaction 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 babelrc option](https://babeljs.io/docs/en/options#babelrc) do not clearly specify what happens when `babelrc: false`. Does it stop searching up the directory tree and look just for a single file or does it stop using babelrc files altogether?

It's not behaving the way I'd expect and I'm not sure if that's because it's broken as [many people have reported](https://github.com/babel/babel-loader/issues/464#issuecomment-411390976) or if it's because I'm making some wrong assumptions about how it should work

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked Babel options documentation at the babelrc section and verify what babelrc: false does, including whether it stops directory searching or disables babelrc files. Update that documentation to state the behavior clearly and explain the relevant assumption; done when the option's effect is unambiguous to readers.

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
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.