doc: document ACL limitation for fs.access on Windows

jasnell · rvagg · commit 0ff88a3510ae · 2018-11-28T11:26:47.000+11:00
Fixes: #19192 PR-URL: #23772 Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Sam Roberts <vieuxtech@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com>
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -565,6 +565,11 @@ In general, check for the accessibility of a file only if the file will not be
 used directly, for example when its accessibility is a signal from another
 process.
 
+On Windows, access-control policies (ACLs) on a directory may limit access to
+a file or directory. The `fs.access()` function, however, does not check the
+ACL and therefore may report that a path is accessible even if the ACL restricts
+the user from reading or writing to it.
+
 ## fs.accessSync(path[, mode])
 <!-- YAML
 added: v0.11.15
