Docs: Not clear why skipDefaultLibCheck recommends skipLibCheck instead

[victorlin]

Page URL:

https://www.typescriptlang.org/tsconfig#skipDefaultLibCheck (source)

Issue:

This is the current description of skipDefaultLibCheck:

Use skipLibCheck instead. Skip type checking of default library declaration files.

The recommendation to use skipLibCheck doesn't come with a meaningful reason.

In my experience, this flag still has an effect even when skipLibCheck is unset. For one project, I am averaging 0.92s when skipDefaultLibCheck=false (default) and 0.61s when skipDefaultLibCheck=true. Because of this, I have a clear use case for using skipDefaultLibCheck but not skipLibCheck.

Recommended Fix:

Remove the suggestion and clarify the difference between skipLibCheck and skipDefaultLibCheck.

[typescript-bot]

Hello! As per #2804, we are automatically closing all open issues. Please see #2804 for a description of what issues and PRs can be accepted going forward.