diff --git a/doc/api/fs.md b/doc/api/fs.md index d2506d28e33cce..9d4c3350298c86 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -4020,7 +4020,7 @@ at the current position. See pwrite(2). It is unsafe to use `filehandle.write()` multiple times on the same file without waiting for the `Promise` to be resolved (or rejected). For this -scenario, [`fs.createWriteStream()`][] is strongly recommended. +scenario, use [`fs.createWriteStream()`][]. On Linux, positional writes do not work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to @@ -4051,7 +4051,7 @@ will be written at the current position. See pwrite(2). It is unsafe to use `filehandle.write()` multiple times on the same file without waiting for the `Promise` to be resolved (or rejected). For this -scenario, [`fs.createWriteStream()`][] is strongly recommended. +scenario, use [`fs.createWriteStream()`][]. On Linux, positional writes do not work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to