diff --git a/doc/api/os.md b/doc/api/os.md
index d14cd1b770e3db..4009e53bcd5eac 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -373,9 +373,8 @@ added: v0.3.3
 
 The `os.uptime()` method returns the system uptime in number of seconds.
 
-*Note*: Within Node.js' internals, this number is represented as a `double`.
-However, fractional seconds are not returned and the value can typically be
-treated as an integer.
+*Note*: On Windows the returned value includes fractions of a second.
+Use `Math.floor()` to get whole seconds.
 
 ## os.userInfo([options])
 <!-- YAML
diff --git a/doc/api/process.md b/doc/api/process.md
index 70156972cb90b1..57fe5ffef427dd 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -1675,6 +1675,9 @@ added: v0.5.0
 The `process.uptime()` method returns the number of seconds the current Node.js
 process has been running.
 
+*Note*: the return value includes fractions of a second. Use `Math.floor()`
+to get whole seconds.
+
 ## process.version
 <!-- YAML
 added: v0.1.3