diff --git a/docs/_pages/library.md b/docs/_pages/library.md
index 72aa6d15..28a9f389 100644
--- a/docs/_pages/library.md
+++ b/docs/_pages/library.md
@@ -759,9 +759,7 @@ Otherwise, `s` is interpreted as a [date format string](https://www.cplusplus.co
 function os.difftime(a: number, b: number): number
 ```
 
-Calculates the difference in seconds between `a` and `b`; provided for compatibility.
-
-It is adviced not to use `os.difftime(a, b)` for new work. Please use `b - a` instead.
+Calculates the difference in seconds between `a` and `b`; provided for compatibility only. Please use `a - b` instead.
 
 ```
 function os.time(t: table?): number