Required and optional parameters are not distinguished.

[fabpico]

Similar to #160 but it sounds that Github has a magic behavior that solves it. I don't let render the markdown in Github, but in Storybook. And in Storybook it looks the same as in PhpStorm.

So the official docs of @param says:

Optional parameters and default values
The following examples show how to indicate that a parameter is optional and has a default value.
An optional parameter (using JSDoc syntax)

/**
 * @param {string} [somebody] - Somebody's name.
 */

So when I do this (I need extra @module to let the Markdown content being created)

/**
 * @module
 * @param {string} [somebody] - Somebody's name.
 */

The rendered results has no explicit optional indication.

PhpStorm

Storybook

When I add a required parameter

/**
 * @module
 * @param {string} somebodyRequired
 * @param {string} [somebody] - Somebody's name.
 */

There is still no explicit distinction, except the in-name literal brackets.

PhpStorm

Storybook

Same problem when using @property

/**
 * @module
 * @property {string} somebodyRequired
 * @property {string} [somebody] - Somebody's name.
 */

PhpStorm

Storybook

What is expected
My expectation is that an additional column should be rendered, which explicitely indicates if the param is required or optional.