Skip to content
This repository was archived by the owner on Mar 23, 2024. It is now read-only.
This repository was archived by the owner on Mar 23, 2024. It is now read-only.

requireHyphenBeforeDescription should not apply to descriptions on next line #1579

@JamesMessinger

Description

@JamesMessinger

The new requireHyphenBeforeDescription option is great, but it should only apply to inline descriptions. If a description is on the next line (usually because it's a long one), then no hyphen should be required.

Example:

/**
 * This function does foo to bar.
 *
 * @param {string} bar
 * This is a really long description of the "bar" parameter.  In fact, the description
 * is so long that it spans multiple lines.
 */
function foo(bar) {

Currently, in order to make this check pass, I have to add a hyphen, like this (which looks weird):

/**
 * This function does foo to bar.
 *
 * @param {string} bar
 * - This is a really long description of the "bar" parameter.  In fact, the description
 * is so long that it spans multiple lines.
 */
function foo(bar) {

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions