eslint-plugin-write-good-comments-2
March 18, 2026 ยท View on GitHub
eslint-plugin-write-good-comments-2 improves source comments with
write-good,
retext-equality,
retext-profanities,
retext-spell,
retext-readability, and
descriptive task-comment enforcement so vague, inconsiderate, misspelled, or
hard-to-read comment text is caught before it spreads through a codebase.
Installation
npm install --save-dev eslint-plugin-write-good-comments-2
Quick start
import writeGoodComments from "eslint-plugin-write-good-comments-2";
export default [writeGoodComments.configs.recommended];
Presets
| Preset | Preset page |
|---|---|
๐ก writeGoodComments.configs.recommended | Recommended |
๐ฃ writeGoodComments.configs.all | All |
Shipped rules
write-good-commentsโ runwrite-goodagainst normal source comment prose.task-comment-formatโ require TODO-style task comments to include a descriptive body.inclusive-language-commentsโ require source comments to avoid exclusionary or inconsiderate language.no-profane-commentsโ disallow profane wording in source comments.spellcheck-commentsโ spellcheck comment prose with a curated technical vocabulary.readability-commentsโ flag comment sentences that are unnecessarily hard to read.
Next steps
- Open Getting Started in this sidebar for installation + usage details.
- Browse Presets for preset-by-preset guidance.
- Use Rules to review each shipped rule with examples and options.