docs: add review suggestions to require()

doc: add review suggestions to require()
PR-URL: nodejs#23605 Reviewed-By: Denys Otrishko <shishugi@gmail.com> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com> Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
[Squash] nits and clarification
Addressing nits and clarifications
nodejs · ErickWendel · ErickWendel · ErickWendel · Oct 12, 2018 · nodejs-github-bot
diff --git a/doc/api/modules.md b/doc/api/modules.md
diff --git a/doc/api/modules.md b/doc/api/modules.md
diff --git a/doc/api/modules.md b/doc/api/modules.md
diff --git a/doc/api/modules.md b/doc/api/modules.md
diff --git 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 `'./`.
diff --git 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 `'./`.
diff --git 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 `'./'`.
diff --git a/doc/api/modules.md b/doc/api/modules.md
+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
diff --git a/doc/api/modules.md b/doc/api/modules.md
+// importing JSON file
+const jsonData = require('./path/filename.json');
+
+// importing module from node_modules or Node.js internals
diff --git a/doc/api/modules.md b/doc/api/modules.md
-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