add in composer at require-dev `JetBrains\PhpStorm\` namespace

[arhimede]

Feature Request

Q	A
New Feature	yes
RFC	no
BC Break	no

Summary

Situation:
In order to mark deprecated stuff, sometimes a developer use something like

use JetBrains\PhpStorm\Deprecated;

which give an error in phpstan validation

Attribute class JetBrains\PhpStorm\Deprecated does not exist.
🪪 attribute.notFound

The solution is to add in composer.json in require-dev section a line like

"jetbrains/phpstorm-attributes": "^1.2"

Do we want to add this line by default in Dotkernel projects ?

@pinclau @alexmerlin

[alexmerlin]

First of all, if it is to be used in the src/ directory, it must be in the require section, not require-dev.
Second, unless used somewhere in the project, it should not be required - maybe a mention or recommendation in the docs/readme.

[alexmerlin]

We can use

/**
 * @deprecated Use Namespace\To\Alternative\Class instead
 */

instead.

Or just

/**
 * @deprecated
 */

if there is no alternative available.

This syntax is understood by all major IDEs.