Skip to content

docs(linter): Improve formatting for 80ish rules' docs.#20411

Merged
graphite-app[bot] merged 1 commit intomainfrom
docs-fixes
Mar 16, 2026
Merged

docs(linter): Improve formatting for 80ish rules' docs.#20411
graphite-app[bot] merged 1 commit intomainfrom
docs-fixes

Conversation

@connorshea
Copy link
Member

@connorshea connorshea commented Mar 15, 2026

Just adding backticks where it makes sense, adding period that were missing from opening sentences for rule docs, and fixing some mistakes with the formatting on method names (Number.toFixed() vs Number#toFixed() and so on).

AI Disclosure: This changeset was helped by Claude Code and then reviewed (each file was only staged after I had looked at the diff) by me.

@connorshea connorshea requested a review from camc314 as a code owner March 15, 2026 21:34
Copilot AI review requested due to automatic review settings March 15, 2026 21:34
@github-actions github-actions bot added A-linter Area - Linter C-docs Category - Documentation. Related to user-facing or internal documentation labels Mar 15, 2026
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

Documentation-only PR that adds backticks around code identifiers, function names, and literals in linter rule doc comments for better rendering.

Changes:

  • Added backticks to inline code references (e.g., defineEmits, Array#join(), structuredClone) across 7 rule documentation blocks.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
valid_define_emits.rs Backtick defineEmits
require_number_to_fixed_digits_argument.rs Backtick Number#toFixed() and 0
require_module_attributes.rs Backtick import/export/import()
require_array_join_separator.rs Backtick Array#join() and ','
prefer_structured_clone.rs Backtick structuredClone
prefer_string_raw.rs Backtick String.raw and \
consistent_empty_array_spread.rs Backtick [] and ''

@connorshea connorshea changed the title docs(linter): Improve formatting for a few rules' docs. docs(linter): Improve formatting for 80ish rules' docs. Mar 15, 2026
@camc314 camc314 added the 0-merge Merge with Graphite Merge Queue label Mar 16, 2026
@camc314 camc314 self-assigned this Mar 16, 2026
Copy link
Contributor

camc314 commented Mar 16, 2026

Merge activity

Just adding backticks where it makes sense, adding period that were missing from opening sentences for rule docs, and fixing some mistakes with the formatting on method names (`Number.toFixed()` vs `Number#toFixed()` and so on).

AI Disclosure: This changeset was helped by Claude Code and then reviewed (each file was only staged after I had looked at the diff) by me.
@graphite-app graphite-app bot merged commit 24490b5 into main Mar 16, 2026
21 checks passed
@graphite-app graphite-app bot deleted the docs-fixes branch March 16, 2026 09:13
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Mar 16, 2026
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-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.

3 participants