diff --git a/docs/core/deploying/single-file/overview.md b/docs/core/deploying/single-file/overview.md
index f57ec1baad00a..6128942b6c5f6 100644
--- a/docs/core/deploying/single-file/overview.md
+++ b/docs/core/deploying/single-file/overview.md
@@ -160,7 +160,7 @@ Only managed DLLs are bundled with the app into a single executable. When the ap
 
 To embed those files for extraction and get one output file, set the property `IncludeNativeLibrariesForSelfExtract` to `true`.
 
-Specifying `IncludeAllContentForSelfExtract` extracts all files, including the managed assemblies, before running the executable. This may be helpful for rare application compatibility problems.
+Specifying `IncludeAllContentForSelfExtract` extracts all files, including the managed assemblies, before running the executable. This may be helpful for rare application compatibility problems. This mode is not recommended: it's a .NET Core 3.1 compatibility mode and might be removed in a future release.
 
 > [!IMPORTANT]
 > If extraction is used, the files are extracted to disk before the app starts: