From b5d8353dc76666baa2c36940726c9cb90394bc7c Mon Sep 17 00:00:00 2001
From: Christopn Noelke <c.noelke@meteocontrol.de>
Date: Sat, 17 Sep 2016 11:03:04 +0200
Subject: [PATCH 1/3] doc: add example for file existence with fs.stat

Add an example on how to test if a file exists with fs.stat. Also add
a link to the Common System Errors.

Fixes: https://github.com/nodejs/issues/6752
---
 doc/api/fs.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 2b9369ffa3b04c..45265f38839dcf 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1517,6 +1517,27 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where
 `stats` is a [`fs.Stats`][] object.  See the [`fs.Stats`][] section for more
 information.
 
+In case of an error, the `err.code` will be one of [Common System Errors][].
+
+For example:
+
+**check for file existence**
+
+```js
+fs.stat('myfile', (err, stats) => {
+  if (err) {
+    if (err.code === 'ENOENT') {
+      console.error('myfile does not exist.');
+      return;
+    } else {
+      throw err;
+    }
+  } else {
+    // work with the file
+  }
+});
+```
+
 ## fs.statSync(path)
 <!-- YAML
 added: v0.1.21
@@ -2200,3 +2221,4 @@ The following constants are meant for use with the [`fs.Stats`][] object's
 [`event ports`]: http://illumos.org/man/port_create
 [`ReadDirectoryChangesW`]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365465%28v=vs.85%29.aspx
 [`AHAFS`]: https://www.ibm.com/developerworks/aix/library/au-aix_event_infrastructure/
+[Common System Errors]: errors.html#errors_common_system_errors
\ No newline at end of file

From fdc7952534f268d6c045ba1e6dcbd3ef1a8cd906 Mon Sep 17 00:00:00 2001
From: Christopn Noelke <c.noelke@meteocontrol.de>
Date: Tue, 4 Oct 2016 18:03:36 +0200
Subject: [PATCH 2/3] clarify doc according to discussion in pull request

---
 doc/api/fs.md | 22 +++++-----------------
 1 file changed, 5 insertions(+), 17 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 45265f38839dcf..b1e085d32d9621 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1519,24 +1519,12 @@ information.
 
 In case of an error, the `err.code` will be one of [Common System Errors][].
 
-For example:
-
-**check for file existence**
+Using `fs.stat()` to check for the existence of a file before calling
+`fs.open()`, `fs.readFile()` or `fs.writeFile()` is not recommended.
+Instead, user code should open/read/write the file directly and handle the
+error raised if the file is not available.
 
-```js
-fs.stat('myfile', (err, stats) => {
-  if (err) {
-    if (err.code === 'ENOENT') {
-      console.error('myfile does not exist.');
-      return;
-    } else {
-      throw err;
-    }
-  } else {
-    // work with the file
-  }
-});
-```
+To check if a file exists without manipulating it afterwards, [`fs.access()`] is recommended.
 
 ## fs.statSync(path)
 <!-- YAML

From 50a54352246b93831f247fa1baed8c01f67bed21 Mon Sep 17 00:00:00 2001
From: Christopn Noelke <c.noelke@meteocontrol.de>
Date: Fri, 7 Oct 2016 13:15:32 +0200
Subject: [PATCH 3/3] fix line length

---
 doc/api/fs.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index b1e085d32d9621..3e2201cf6d44ed 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1524,7 +1524,8 @@ Using `fs.stat()` to check for the existence of a file before calling
 Instead, user code should open/read/write the file directly and handle the
 error raised if the file is not available.
 
-To check if a file exists without manipulating it afterwards, [`fs.access()`] is recommended.
+To check if a file exists without manipulating it afterwards, [`fs.access()`]
+is recommended.
 
 ## fs.statSync(path)
 <!-- YAML