diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md
index 96524823..a901ed58 100644
--- a/docs/advanced-usage.md
+++ b/docs/advanced-usage.md
@@ -413,6 +413,7 @@ steps:
   # Or pip install -e '.[test]' to install test dependencies
 ```
 Note: cache-dependency-path supports files located outside the workspace root by copying them into the workspace to enable proper caching.
+To avoid unintentionally overwriting existing files in the workspace (especially when using composite actions with common file names like requirements.txt), a new input overwrite has been added. By default, files will not be copied if a file with the same path already exists in the workspace unless overwrite: true is explicitly set.
 # Outputs and environment variables
 
 ## Outputs