Add 'no-redundant-jsdoc' rule

[andy-hanson]

PR checklist

• Addresses an existing issue: #0000
• New feature, bugfix, or enhancement
  • Includes tests
• Documentation update

Overview of change:

Adds the no-redundant-jsdoc rule, which forbids unnecessary redundant JSDoc, as in:

/**
 * @export
 * @function
 * @name f
 * @param {number} x
 * @returns {void}
 */
export function f(x: number): void;

CHANGELOG.md entry:

[new-rule] no-redundant-jsdoc

[ajafff]

please don't do that
that should be done upstream in typescript. IIRC there's already an issue with a feature request for something like node.getJsDoc()

[adidahiya]

agreed, let's wait for this to be fixed upstream.

[adidahiya]

agreed, let's wait for this to be fixed upstream.

[JoshuaKGoldberg]

Perhaps keeping a Set of these would be a little more efficient & less code?

[ajafff]

@andy-hanson are you still interested in getting this merged?

Since the jsDoc property is still not public in typescript, I added two utility functions to the latest version of tsutils to deal with JsDoc: canHaveJsDoc and getJsDoc.

If you don't want to continue here, just leave me a message if you are ok with me finishing your PR.