Skip to content

Checks whether a documentation description introduces any new information. ℹ️

License

Notifications You must be signed in to change notification settings

JoshuaKGoldberg/are-docs-informative

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Are Docs Informative

Checks whether a documentation description introduces any new information. ℹ️

All Contributors: 1 👪 Codecov Test Coverage Contributor Covenant License: MIT Sponsor: On GitHub Style: Prettier TypeScript: Strict npm package version

See this in action in eslint-plugin/jsdoc's jsdoc/informative-docs rule!

Usage

npm i are-docs-informative
import { areDocsInformative } from "are-docs-informative";

areDocsInformative("The user id.", "userId"); // false
areDocsInformative("Retrieved user id.", "userId"); // true

Options

The areDocsInformative function can receive a third, optional object parameter. It can contain any of the following properties.

aliases

The aliases option allows indicating words as synonyms (aliases) of each other.

For example, with { aliases: { emoji: ["smiley", "winkey"] } }, the following comment would be considered uninformative:

/** Default smiley/winkey. */
export const defaultSmiley = "🙂";

The default aliases option is:

{
	"a": ["an", "our"]
}

uselessWords

Words that are ignored when searching for one that adds meaning.

For example, with { uselessWords: ["our"] }, the following comment would be considered uninformative:

/** Our text. */
export const text = ":)";

The default uselessWords option is:

["a", "an", "i", "in", "of", "s", "the"]

Development

See .github/CONTRIBUTING.md, then .github/DEVELOPMENT.md. Thanks! 💖

Contributors

Josh Goldberg
Josh Goldberg

🔧 📖 💻

💙 This package is based on @JoshuaKGoldberg's template-typescript-node-package.

About

Checks whether a documentation description introduces any new information. ℹ️

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published