diff --git a/doc/api/fs.md b/doc/api/fs.md
index 643efaae03395d..41467e9089b3d7 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1533,6 +1533,9 @@ changes:
 Asynchronous close(2). No arguments other than a possible exception are given
 to the completion callback.
 
+Calling `fs.close` on any file descriptor (`fd`) that is currently in use
+through `fs.read`, `fs.write` or `fs.writev` may lead to undefined behavior.
+
 ## fs.closeSync(fd)
 <!-- YAML
 added: v0.1.21