From 18f6f8e0b092241b2a1d2228a51fd7254d44e38d Mon Sep 17 00:00:00 2001
From: erickwendel <erick.workspace@gmail.com>
Date: Fri, 12 Oct 2018 11:33:59 -0700
Subject: [PATCH 1/2] docs: add review suggestions to require()

---
 doc/api/modules.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/doc/api/modules.md b/doc/api/modules.md
index 59c589e83ac233..cd53eb2c76be40 100644
--- a/doc/api/modules.md
+++ b/doc/api/modules.md
@@ -552,7 +552,18 @@ added: v0.1.13
 
 * {Function}
 
-To require modules.
+Used to import modules, `JSON` and local files. Modules can be imported from `node_modules`. Local modules and JSON files can be imported using the pattern `'./'`.
+
+```js
+// importing localModule
+const myLocalModule = require('./path/myLocalModule');
+
+// importing JSON file
+const jsonData = require('./path/filename.json');
+
+// importing module from node_modules or Node.js internals
+const crypto = require('crypto');
+```
 
 #### require.cache
 <!-- YAML

From 47ce2915a3480887544d02b0c10e295b32a9289a Mon Sep 17 00:00:00 2001
From: James M Snell <jasnell@gmail.com>
Date: Tue, 16 Oct 2018 07:57:49 -0700
Subject: [PATCH 2/2] [Squash] nits and clarification

Addressing nits and clarifications
---
 doc/api/modules.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/doc/api/modules.md b/doc/api/modules.md
index cd53eb2c76be40..2475fa2755e6d3 100644
--- a/doc/api/modules.md
+++ b/doc/api/modules.md
@@ -552,16 +552,20 @@ added: v0.1.13
 
 * {Function}
 
-Used to import modules, `JSON` and local files. Modules can be imported from `node_modules`. Local modules and JSON files can be imported using the pattern `'./'`.
+Used to import modules, `JSON`, and local files. Modules can be imported
+from `node_modules`. Local modules and JSON files can be imported using
+a relative path (e.g. `./`, `./foo`, `./bar/baz`, `../foo`) that will be
+resolved against the directory named by [`__dirname`][] (if defined) or
+the current working directory.
 
 ```js
-// importing localModule
+// Importing a local module:
 const myLocalModule = require('./path/myLocalModule');
 
-// importing JSON file
+// Importing a JSON file:
 const jsonData = require('./path/filename.json');
 
-// importing module from node_modules or Node.js internals
+// Importing a module from node_modules or Node.js built-in module:
 const crypto = require('crypto');
 ```