From c329281e94d76ad73a9bbd70c2dff6bbb76c0f25 Mon Sep 17 00:00:00 2001
From: omkar podey <58183-omkar.podey@users.noreply.drupalcode.org>
Date: Tue, 18 Apr 2023 15:31:29 +0000
Subject: [PATCH] Issue #3351069 by omkar.podey, tedbow, Wim Leers, yash.rode,
 phenaproxima: Update package_manager.api.php to document an assumption

---
 package_manager/package_manager.api.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/package_manager/package_manager.api.php b/package_manager/package_manager.api.php
index d288666b8a..51da677192 100644
--- a/package_manager/package_manager.api.php
+++ b/package_manager/package_manager.api.php
@@ -201,6 +201,14 @@
  *   secure-http configuration option must be enabled). This is the default
  *   behavior.
  *
+ * Package Manager also assumes certain things that it does not explicitly
+ * enforce or check:
+ *
+ * - Only Composer operations should be performed on the stage directory. If
+ *   other file operations were performed, any newly created files might not
+ *   be copied back to the active site because of
+ *   \Drupal\package_manager\PathExcluder\UnknownPathExcluder.
+ *
  * Event subscribers which enforce these and other constraints are referred to
  * as validators.
  *
-- 
GitLab