From 5bdfc730438da32852a6199b1bbe87f71a729660 Mon Sep 17 00:00:00 2001
From: Conor ONeill <cwjoneill@gmail.com>
Date: Tue, 28 Jan 2020 16:06:56 +0000
Subject: [PATCH 1/3] doc: Add example to fs.promises.readdir

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

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 9ed072ad1e4871..db00c5e4e73ec1 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -4929,6 +4929,20 @@ will be passed as `Buffer` objects.
 If `options.withFileTypes` is set to `true`, the resolved array will contain
 [`fs.Dirent`][] objects.
 
+Example using async iteration:
+
+```js
+const fs = require('fs');
+
+async function print(path) {
+  const files = await fs.promises.readdir(path);
+  for (const file of files) {
+    console.log(file);
+  }
+}
+print('./').catch(console.error);
+```
+
 ### `fsPromises.readFile(path[, options])`
 <!-- YAML
 added: v10.0.0

From 58b1c1a4d4ec456480aea3e2ccbd2b49daea1a3f Mon Sep 17 00:00:00 2001
From: Conor O'Neill <conor@conoroneill.com>
Date: Tue, 28 Jan 2020 16:17:51 +0000
Subject: [PATCH 2/3] Update doc/api/fs.md

Co-Authored-By: James M Snell <jasnell@gmail.com>
---
 doc/api/fs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index db00c5e4e73ec1..9e1accbdccae7d 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -4929,7 +4929,7 @@ will be passed as `Buffer` objects.
 If `options.withFileTypes` is set to `true`, the resolved array will contain
 [`fs.Dirent`][] objects.
 
-Example using async iteration:
+Example iterating over a directory listing:
 
 ```js
 const fs = require('fs');

From 700feab983b8eef9588c6b543c719cbb8fc03256 Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Mon, 3 Feb 2020 14:30:46 -0800
Subject: [PATCH 3/3] fixup! Update doc/api/fs.md

---
 doc/api/fs.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 9e1accbdccae7d..c17265e9b4324b 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -4929,8 +4929,6 @@ will be passed as `Buffer` objects.
 If `options.withFileTypes` is set to `true`, the resolved array will contain
 [`fs.Dirent`][] objects.
 
-Example iterating over a directory listing:
-
 ```js
 const fs = require('fs');