Due to the initiative to create separate dedicated Annotation (#1966246: [meta] Introduce specific annotations for each plugin type)
the question came up: How do we document that a certain key needs a wrapped @Translation.
Some suggestions:
/**
* The description of the plugin.
*
* The string should be wrapped in a @Translatable()
*
* @var string
*/
public $description; /**
* The description of the plugin.
*
* @see \Drupal\Core\Annotation\Translation
*
* @var string
*/
public $description; /**
* The description of the plugin.
*
* @var \Drupal\Core\Annotation\Translation
*/
public $description;