Skip to content

docs(linter): improve --tsconfig flag docs#20342

Merged
graphite-app[bot] merged 1 commit intomainfrom
c/03-13-docs_linter_improve_--tsconfig_flag_docs
Mar 13, 2026
Merged

docs(linter): improve --tsconfig flag docs#20342
graphite-app[bot] merged 1 commit intomainfrom
c/03-13-docs_linter_improve_--tsconfig_flag_docs

Conversation

@camc314
Copy link
Contributor

@camc314 camc314 commented Mar 13, 2026

Related to #20328

Copy link
Contributor Author

camc314 commented Mar 13, 2026


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent changes, fast-track this PR to the front of the merge queue

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions github-actions bot added A-linter Area - Linter A-cli Area - CLI C-docs Category - Documentation. Related to user-facing or internal documentation labels Mar 13, 2026
@camc314 camc314 self-assigned this Mar 13, 2026
@camc314 camc314 marked this pull request as ready for review March 13, 2026 11:55
Copilot AI review requested due to automatic review settings March 13, 2026 11:56
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates Oxlint CLI documentation to better explain the scope and limitations of the --tsconfig flag, particularly in relation to import resolution vs. type-aware/type-checking behavior (related to #20328).

Changes:

  • Reword --tsconfig help text to describe it as an override for import-resolution tsconfig discovery.
  • Add a note clarifying that type-aware/type-checking still uses automatically discovered tsconfig (not affected by --tsconfig).
  • Simplify --import-plugin docs by removing the old coupling guidance to --tsconfig.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
tasks/website_linter/src/snapshots/cli_terminal.snap Updates terminal help snapshot to match new --tsconfig / --import-plugin wording.
tasks/website_linter/src/snapshots/cli.snap Updates website/markdown CLI docs snapshot, including the new NOTE about type-aware behavior.
apps/oxlint/src/command/lint.rs Adjusts bpaf help text for --tsconfig and --import-plugin to match clarified docs.

You can also share your feedback on Copilot code review. Take the survey.

@camc314 camc314 force-pushed the c/03-13-docs_linter_improve_--tsconfig_flag_docs branch from c68477c to 1bd03de Compare March 13, 2026 12:03
@graphite-app
Copy link
Contributor

graphite-app bot commented Mar 13, 2026

Merge activity

@graphite-app graphite-app bot force-pushed the c/03-13-docs_linter_improve_--tsconfig_flag_docs branch from 1bd03de to 3383523 Compare March 13, 2026 12:15
@graphite-app graphite-app bot merged commit 3383523 into main Mar 13, 2026
19 checks passed
@graphite-app graphite-app bot deleted the c/03-13-docs_linter_improve_--tsconfig_flag_docs branch March 13, 2026 12:27
camc314 pushed a commit that referenced this pull request Mar 16, 2026
# Oxlint
### 🚀 Features

- c95951f linter/plugins: Implement `sourceCode.markVariableAsUsed` (#20357) (overlookmotel)
- 7a2a7d0 linter: Implement `n/handle-callback-err` rule (#19616) (Mikhail Baev)

### 🐛 Bug Fixes

- f8fbd6e linter/plugins: Remove `hashbang` property from AST (#20365) (overlookmotel)
- 6eb5b01 linter/prefer-await-to-then: Ignore Promise static methods (#20347) (camc314)
- a4b61f7 linter: Remove `defineConfig` check (#20308) (camc314)
- 3ad7f53 linter/explicit-module-boundary-types: False positive with satisfies expr (#20309) (camc314)
- f547401 linter/no-unused-private-class-members: Treat switch discriminants as read (#20307) (camc314)
- 1c07b3b diagnostics: Handle `WouldBlock` in stdout writes to prevent panic (#20295) (Boshen)

### ⚡ Performance

- e4f7248 linter: Remove unnecessary clone of owned String in drain loop (#20388) (Boshen)
- 4a67f1d linter: Eliminate Vec allocation in disable directive matching (#20387) (Boshen)
- 618a598 linter/plugins: Add fast path for files with no comments (#20366) (overlookmotel)
- b0125c5 linter/plugins: Deserialize comments without AST (#20364) (overlookmotel)
- 9cd612f linter/plugins: Recycle comment objects (#20362) (overlookmotel)
- bf442f8 linter/plugins: Cheaper `Token` creation (#20360) (overlookmotel)
- 5474d0a semantic: V8-style walk-up reference resolution (#20292) (Boshen)
- 7946eba linter/plugins: Avoid arguments spread and temp array when merging (#20318) (overlookmotel)
- fc7cf8a linter/plugins: Pre-define less CFG merger functions (#20317) (overlookmotel)
- 3b9eb28 linter/plugins: Streamline getting/creating visit fn mergers (#20319) (overlookmotel)
- f04e850 linter/plugins: Inline binary search functions into call sites (#20312) (overlookmotel)
- fe24afe linter/plugins: Apply replace globals TSDown plugin to JS files (#20305) (overlookmotel)
- 77cdacc linter/plugins: Use array buffer views for tokens (#20301) (overlookmotel)
- 910c941 linter/plugins: Reorder branches in `getTokenByRangeStart` (#20296) (overlookmotel)
- af7674c linter/tokens: Avoid extra token value allocation (#20013) (camc314)

### 📚 Documentation

- 24490b5 linter: Improve formatting for 80ish rules' docs. (#20411) (connorshea)
- 3383523 linter: Improve `--tsconfig` flag docs (#20342) (camc314)
# Oxfmt
### 🚀 Features

- d22c443 oxfmt: Export `OxfmtConfig` type (#20275) (leaysgur)
- a11ecff oxfmt/lsp: Respect `angular` language id as `.component.html` file (#20242) (Sysix)

### 🐛 Bug Fixes

- ce65099 formatter: Preserve parentheses around as expression before private field access (#20419) (bab)
- f908742 oxfmt: Revert #20326 partially (#20413) (leaysgur)
- 4ef93ea formatter: Honor trailing ignore comments after list separators (#19925) (Andreas Lubbe)
- 68fb0d0 oxfmt: Skip vite.config.ts which fails to import (#20326) (leaysgur)
- 88ee826 oxfmt: Handle literalline for script-in-vue (#20130) (leaysgur)
- 1c07b3b diagnostics: Handle `WouldBlock` in stdout writes to prevent panic (#20295) (Boshen)

Co-authored-by: Boshen <1430279+Boshen@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-cli Area - CLI A-linter Area - Linter C-docs Category - Documentation. Related to user-facing or internal documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants