diff --git a/crates/extension_api/wit/since_v0.8.0/extension.wit b/crates/extension_api/wit/since_v0.8.0/extension.wit
index 8195162b89a420d322970bf894bd9ec824119087..fc2735c72b463225feed0d371ae8274b56c78be1 100644
--- a/crates/extension_api/wit/since_v0.8.0/extension.wit
+++ b/crates/extension_api/wit/since_v0.8.0/extension.wit
@@ -57,6 +57,8 @@ world extension {
     import download-file: func(url: string, file-path: string, file-type: downloaded-file-type) -> result<_, string>;
 
     /// Makes the file at the given path executable.
+    ///
+    /// This is a no-op on Windows.
     import make-file-executable: func(filepath: string) -> result<_, string>;
 
     /// Updates the installation status for the given language server.