doc: document opening hidden files on Windows

PR-URL: #15409
Fixes: #14553
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Ben Noordhuis <[email protected]>
Reviewed-By: Nikolai Vavilov <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>

Author: bzoz

doc/api/fs.md

@@ -102,6 +102,11 @@ example `fs.readdirSync('c:\\')` can potentially return a different result than
 `fs.readdirSync('c:')`. For more information, see
 [this MSDN page][MSDN-Rel-Path].
 
+*Note:* On Windows, opening an existing hidden file using the `w` flag (either
+through `fs.open` or `fs.writeFile`) will fail with `EPERM`. Existing hidden
+files can be opened for writing with the `r+` flag. A call to `fs.ftruncate` can
+be used to reset the file contents.
+
 ## Threadpool Usage
 
 Note that all file system APIs except `fs.FSWatcher()` and those that are