Override PHPDoc return types for methods of User entity

$drupal_user = User::create();
$drupal_user->setUsername($username);

In example above we will have $drupal_user variable of \Drupal\Core\Entity\EntityInterface type and will not have an autosuggestion feature which is provided by a lot of editors/IDEs.

Proposition is to add PHPDoc annotations to entity definitions with overridden return type.

Example:

/**
 * @method static User load($id)
 * @method static User create(array $values = [])
 * @method static User[] loadMultiple(array $ids = NULL)
 * @method User createDuplicate()
 */