Inline class annotation with /** @var or just comments?
I checked more about annotations and it doesnt makes sense to have them in places other then outside the class, as stated on d.org, so this is just plain comment for IDE's to connect what is used there.


  In addition, there is a performance bonus as it makes Drupal use less
  memory when discovering plugins. The original implementation had a
  getInfo() method on each class, similar to Drupal 7 test classes. This
  meant each class had to be loaded into memory to get its information
  and the memory was not freed until the end of the request, thus
  greatly increasing the peak memory requirement for PHP. Instead, the
  implementation used by Drupal to parse the annotation simply tokenizes
  the text of the file without including it as a PHP file, so memory use
  is minimized.