A lot of plugins in core have a copy/pasted constructor documentation that should be tailored to the specific plugin.
See all instances of Constructs a Drupal\Component\Plugin\PluginBase object. current in core:
core/modules/aggregator/src/Plugin/views/argument/Fid.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/aggregator/src/Plugin/views/argument/Iid.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/ckeditor/src/Plugin/Editor/CKEditor.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/comment/src/Plugin/views/argument/UserUid.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/comment/src/Plugin/views/field/NodeNewComments.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/node/src/Plugin/views/argument/Vid.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/user/src/Plugin/views/argument/Uid.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/user/src/Plugin/views/field/Permissions.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
core/modules/user/src/Plugin/views/field/Roles.php: * Constructs a Drupal\Component\Plugin\PluginBase object.
I don't think they need anything fancy, just maybe replaced with the actual plugin object being constructed.