diff --git a/doc/api/fs.md b/doc/api/fs.md index 11f03c8a2caac7..114ecfa97c0056 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -3982,7 +3982,7 @@ changes: * `string` {string} Write `string` to the file specified by `fd`. If `string` is not a string, then -the value will be coerced to one. +an exception will be thrown. `position` refers to the offset from the beginning of the file where this data should be written. If `typeof position !== 'number'` the data will be written at @@ -4044,7 +4044,7 @@ changes: * `err` {Error} When `file` is a filename, asynchronously writes data to the file, replacing the -file if it already exists. `data` can be a string or a buffer. +file if it already exists. `data` can be a string or a buffer. When `file` is a file descriptor, the behavior is similar to calling `fs.write()` directly (which is recommended). See the notes below on using