Automatically generates and maintains documentation for ESLint plugins and rules, including rule tables, config tables, and rule doc notices.
eslint-doc-generator is a Node.js tool that automatically generates and maintains documentation for ESLint plugins and rules. It creates README tables, rule doc headers, and options lists based on plugin metadata, ensuring consistency and reducing manual documentation work. It solves the problem of fragmented and outdated ESLint plugin documentation by automating the process.
ESLint plugin maintainers and developers who want to keep their plugin documentation up-to-date and standardized. It's particularly useful for popular ESLint plugins with many rules and configurations.
Developers choose eslint-doc-generator because it eliminates the need for custom documentation scripts, ensures documentation stays synchronized with rule changes, and follows ESLint's official documentation conventions. Its configurability and adoption by major ESLint plugins make it a trusted solution.
Automatic documentation generator for ESLint plugins and rules.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Generates consistent rules and configs tables following ESLint conventions, eliminating fragmentation across plugins as noted in the motivation.
Supports custom columns, emojis, AI suggestions, and integration with prettier/markdownlint, allowing tailored output for different plugin needs.
Performs section consistency checks on rule docs, ensuring required options sections are present and named options are mentioned, catching errors early.
Used by popular plugins like eslint-plugin-import and eslint-plugin-react, demonstrating reliability and community trust.
Requires setup with build tools, markdownlint, and prettier, potentially needing custom postprocessing scripts for seamless workflows.
Rule option lists rely on detailed meta.schema properties; plugins with sparse schemas won't benefit fully, and output is subject-to-change with updates.
AI-assisted suggestions require external API keys and providers, adding cost, dependency, and setup overhead beyond the core tool.
The tool warns that generated documentation can change in any release, potentially breaking CI checks without manual updates.