Package Exports

are-docs-informative
are-docs-informative/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (are-docs-informative) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Are Docs Informative

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

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}
🔧 📖 🚇 💻 🖋 🤔 🚧 📆

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