Issue #2960381 by roshni27, joachim, apaderno, smustgrave: Docs for...

Issue #2960381 by roshni27, joachim, apaderno, smustgrave: Docs for FactoryInterface::createInstance() and MapperInterface::getInstance() are too similar and need more detail

core/lib/Drupal/Component/Plugin/Factory/FactoryInterface.php

@@ -8,7 +8,7 @@
 interface FactoryInterface {
 
   /**
-   * Creates a pre-configured instance of a plugin.
+   * Creates a plugin instance based on the provided ID and configuration.
    *
    * @param string $plugin_id
    *   The ID of the plugin being instantiated.

core/lib/Drupal/Component/Plugin/Mapper/MapperInterface.php

@@ -14,7 +14,7 @@
 interface MapperInterface {
 
   /**
-   * Gets a preconfigured instance of a plugin.
+   * Gets or creates a plugin instance that satisfies the given options.
    *
    * @param array $options
    *   An array of options that can be used to determine a suitable plugin to