diff --git a/doc/api/fs.markdown b/doc/api/fs.markdown
index 437ba732f8..0b06533335 100644
--- a/doc/api/fs.markdown
+++ b/doc/api/fs.markdown
@@ -290,7 +290,8 @@ returns a buffer.
 
 ### fs.writeFile(filename, data, encoding='utf8', [callback])
 
-Asynchronously writes data to a file. `data` can be a string or a buffer.
+Asynchronously writes data to a file, replacing the file if it already exists.
+`data` can be a string or a buffer.
 
 Example: