From 02f6f6c68810136d707492c2c4cdb60025deaef3 Mon Sep 17 00:00:00 2001
From: xjm <xjm@65776.no-reply.drupal.org>
Date: Thu, 9 Nov 2023 18:08:56 -0600
Subject: [PATCH] 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 | 2 +-
 core/lib/Drupal/Component/Plugin/Mapper/MapperInterface.php   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/core/lib/Drupal/Component/Plugin/Factory/FactoryInterface.php b/core/lib/Drupal/Component/Plugin/Factory/FactoryInterface.php
index 8cf046b9c0df..4b1c2ad5af44 100644
--- a/core/lib/Drupal/Component/Plugin/Factory/FactoryInterface.php
+++ b/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.
diff --git a/core/lib/Drupal/Component/Plugin/Mapper/MapperInterface.php b/core/lib/Drupal/Component/Plugin/Mapper/MapperInterface.php
index 9b01a374a507..a53b14e7f53d 100644
--- a/core/lib/Drupal/Component/Plugin/Mapper/MapperInterface.php
+++ b/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
-- 
GitLab