diff --git a/doc/api/os.md b/doc/api/os.md
index 3f11ed65e5f163..bbc4c30cdb71d4 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -76,6 +76,8 @@ added: v0.3.3
 * Returns: {Object\[]}
 
 Returns an array of objects containing information about each logical CPU core.
+The array will be empty if no CPU information is available, such as if the
+`/proc` file system is unavailable.
 
 The properties included on each object include: