doc: expand fs.watch caveats

Document Windows specific fs.watch caveats.

Fixes: #31702

PR-URL: #32176
Reviewed-By: Ben Noordhuis <[email protected]>
Reviewed-By: Masashi Hirano <[email protected]>
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: James M Snell <[email protected]>

Author: bzoz

doc/api/fs.md

@@ -3758,6 +3758,9 @@ unavailable in some situations.
 
 The recursive option is only supported on macOS and Windows.
 
+On Windows, no events will be emitted if the watched directory is moved or
+renamed. An `EPERM` error is reported when the watched directory is deleted.
+
 #### Availability
 
 <!--type=misc-->