Single line @inheritdoc shouldn't be allowed?

[celorodovalho]

Description

Accord with https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc.md#2-conventions-used-in-this-document, we can use single line annotations for @inheritdoc DocBlocks. But, there is no mention about "single line / inline @inheritdoc" in Magento Guidelines (https://devdocs.magento.com/guides/v2.3/coding-standards/docblock-standard-general.html#inheritdoc), and if run the phpcs from Magento, I got a exception about:

You must use "*/" to end a function comment; found "/** @inheritdoc */"

Expected behavior

Allowance to use single line / inline DocBlocks to @inheritdoc

Benefits

Conformity with php-fig default standards

Additional information

If I use:

    /**
     * @inheritdoc
     */

Like described in documentation () I still get a error:

The incorrect inherit doc tag usage. Should be {@inheritdoc}

Why? If I want to inherit the entire doc block from the parent method?

[orlangur]

Thanks @lenaorobei. Inheritdoc is currently under process of complete removal in Vinai devdocs PR.

[lenaorobei]

@celorodovalho please refer this PR for more details magento/devdocs#4425

[lenaorobei]

@celorodovalho mentioned PR is merged DevDocs are reflecting Magento recommendation.
https://devdocs.magento.com/guides/v2.3/coding-standards/docblock-standard-general.html

We also have an issue to implement corresponding rule and replace with the existing one #54

If you feel like DevDocs contain wrong information please do not hesitate to open magento/devdocs issue.