diff --git a/platform-includes/troubleshooting/dotnet.mdx b/platform-includes/troubleshooting/dotnet.mdx
index 11287b4ef7729..ba291818022b8 100644
--- a/platform-includes/troubleshooting/dotnet.mdx
+++ b/platform-includes/troubleshooting/dotnet.mdx
@@ -50,3 +50,11 @@ using SentrySession = Sentry.Session;
 ```
 
 Then `SentrySession` can be used instead of `Sentry.Session`.
+
+### Visual Studio Hot Restart Incompatibility
+
+Attempting to build a .NET MAUI iOS app will result in an error if you use Visual Studio Hot Restart when developing on Windows with a remote Mac:
+
+> The xcframework sentry.bindings.cocoa\5.0.1\lib\net8.0-ios17.0\Sentry.Bindings.Cocoa.resources.zip has an incorrect or unknown format and cannot be processed.
+
+This happens because Hot Restart does not support static iOS libraries or frameworks containing static libraries, as detailed in the [Microsoft documentation](https://learn.microsoft.com/en-us/dotnet/maui/ios/hot-restart?view=net-maui-9.0#limitations).