From 6c028114569a134821d3d9a5abf45f988ad406ca Mon Sep 17 00:00:00 2001
From: catch <catch@35733.no-reply.drupal.org>
Date: Fri, 21 Jul 2023 13:49:19 +0100
Subject: [PATCH] Issue #3368277 by sidharth_soman, joachim: document that
 config/optional is safe to use with duplicate configuration

---
 core/core.api.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/core/core.api.php b/core/core.api.php
index 361f42375de7..97cbfd05b277 100644
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -246,7 +246,10 @@
  *   module B some time later, then module A's config/optional directory will be
  *   scanned at that time for newly met dependencies, and the configuration will
  *   be installed then. If module B is never installed, the configuration item
- *   will not be installed either.
+ *   will not be installed either. Optional configuration items are ignored if
+ *   they already exist or if they are not configuration entities (this also
+ *   includes configuration that has an implicit dependency on modules that
+ *   are not yet installed).
  * - Exporting and importing configuration.
  *
  * The file storage format for configuration information in Drupal is
-- 
GitLab