diff --git a/doc/api/fs.md b/doc/api/fs.md
index 46b61f00127e0a..6c8cbf42dc8d4e 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -2004,6 +2004,9 @@ changes:
 Asynchronous rmdir(2). No arguments other than a possible exception are given
 to the completion callback.
 
+*Note*: Using `fs.rmdir()` on a file (not a directory) results in an `ENOENT`
+error on Windows and an `ENOTDIR` error on POSIX.
+
 ## fs.rmdirSync(path)
 <!-- YAML
 added: v0.1.21
@@ -2018,6 +2021,9 @@ changes:
 
 Synchronous rmdir(2). Returns `undefined`.
 
+*Note*: Using `fs.rmdirSync()` on a file (not a directory) results in an `ENOENT`
+error on Windows and an `ENOTDIR` error on POSIX.
+
 ## fs.stat(path, callback)
 <!-- YAML
 added: v0.0.2