Description

If classes/interfaces/functions/constants/class members are marked as @deprecated the description and @see tag must be provided.

Motivation behind the added @deprecated tag MUST be explained. @see tag MUST be used with reference to new implementation when code is deprecated and there is a new alternative.

Expected behavior

In PHPDoc blocs @deprecated tag must have description and following @see tag with reference.

Good example:

    /**
     * @var string
     * @deprecated 100.2.0 Useful description here.
     * @see /NameSpace/To/Implementation
     */
    protected $classMemberName;

Bad example:

    /**
     * @var string
     * @deprecated
     */
    protected $classMemberName;