doc: improve text in fs docs about omitting callbacks

Repair misplaced colon and condense text. PR-URL: #34307 Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]> Reviewed-By: James M Snell <[email protected]>
nodejs · Jul 16, 2020 · d114961 · d114961
1 parent 24f76cf
commit d114961
Showing 1 changed file with 4 additions and 7 deletions.
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -79,13 +79,10 @@ In busy processes, use the asynchronous versions of these calls. The synchronous
 versions will block the entire process until they complete, halting all
 connections.
 
-While it is not recommended, most fs functions allow the callback argument to
-be omitted, in which case a default callback is used that rethrows errors. To
-get a trace to the original call site, set the `NODE_DEBUG` environment
-variable:
-
-Omitting the callback function on asynchronous fs functions is deprecated and
-may result in an error being thrown in the future.
+Most asynchronous `fs` functions allow the callback argument to be omitted.
+However, this usage is deprecated. When the callback is omitted, a default
+callback is used that rethrows errors. To get a trace to the original call site,
+set the `NODE_DEBUG` environment variable:
 
 ```console
 $ cat script.js