Jira issue originally created by user pulse00:
If an IDE would like to support annotations, it's currently only possible to display all resolvable classes in a code-hint menu when autocompleting annotations, as
basically any class can be used for annotations.
To make it possible for IDEs to detect classes which are explicitly meant to be used as annotations, it would be nice to agree on some common
way of documenting annotations in PHPDocBlocks.
Here's an example of what this could look like:
This way IDEs can prioritize annotated classes in code-hints and add additional information to the user.