Skip to content

Add lint rule to validate type descriptions in README#1396

Draft
som-sm wants to merge 4 commits intomainfrom
feat/lint-rule-to-validate-readme-against-jsdoc
Draft

Add lint rule to validate type descriptions in README#1396
som-sm wants to merge 4 commits intomainfrom
feat/lint-rule-to-validate-readme-against-jsdoc

Conversation

@som-sm
Copy link
Copy Markdown
Collaborator

@som-sm som-sm commented Mar 31, 2026

This PR adds a lint rule that enforces that type descriptions in the README exactly match the first line of their source JSDoc.

image

The lint caught 68 mismatches in the existing README file.

Repository owner deleted a comment from claude bot Mar 31, 2026
Repository owner deleted a comment from claude bot Mar 31, 2026
@som-sm
Copy link
Copy Markdown
Collaborator Author

som-sm commented Mar 31, 2026

xo.config.js uses the FlatXoConfig type from xo, and FlatXoConfig itself relies on eslint types. However, those eslint types are being incorrectly resolved from @types/eslint, which is causing errors in the config.

I’ve opened a discussion in the ESLint repository about this: eslint/eslint#20704.

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.

1 participant