Adequate our use of `@link` tag

The spec defines [block and inline tags](http://usejsdoc.org/about-block-inline-tags.html). `@block` stand on their own, inline tags live within the description of block level tags and are wrapped by `{}`. Example:

> @block-tag {type} A description with {@inline-tag} within it.

It looks like `@link` is an [inline-only tag](http://usejsdoc.org/tags-inline-link.html). Tools actually implement the `@link` as block and inline, so it's a non-issue at a practical level.

## Action items

- Add a linting rule to prevent block-level use of the `@link` tag
- ~When the link tag is used as a block-level tag, we should substitute it by the `@see` tag instead.~ https://github.com/WordPress/gutenberg/pull/15616

Bad:

```
/**
 * Handles a delete keyDown event to handle merge or removal for collapsed
 * selection where caret is at directional edge: forward for a delete key,
 * reverse for a backspace key.
 *
 * @link https://en.wikipedia.org/wiki/Caret_navigation
 *
 * @param {KeyboardEvent} event Keydown event.
 */
```

Good:

```
/**
 * Handles a delete keyDown event to handle merge or removal for collapsed
 * selection where caret is at directional edge: forward for a delete key,
 * reverse for a backspace key.
 *
 * @see https://en.wikipedia.org/wiki/Caret_navigation
 *
 * @param {KeyboardEvent} event Keydown event.
 */
```


Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adequate our use of `@link` tag #14334

Action items

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Adequate our use of @link tag #14334

Description

Action items

Metadata

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Issue actions

Adequate our use of `@link` tag #14334