GitHub - JoshuaKGoldberg/are-docs-informative: Checks whether a documentation description introduces any new information. ℹ️ (original) (raw)

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

Usage

See this in action in jsdoc/informative-docs!

npm i are-docs-informative

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

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

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

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:

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"]

💝 This package was templated with create-typescript-app using the Bingo framework.