diff --git a/doc/api/os.md b/doc/api/os.md
index 480305a7e1..44bbe0b437 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -378,9 +378,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 e351d3cce7..306f555e4f 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -1672,6 +1672,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