eliminating personal pronouns

timotew · Jan 4, 2018 · Jan 4, 2018 · Jan 4, 2018 · Jan 4, 2018 · Jan 4, 2018
commit 5427e5ad97dc07e64acc907e0840a5cd9216f803
diff --git a/doc/api/synopsis.md b/doc/api/synopsis.md
@@ -12,32 +12,26 @@ different options and ways to run scripts with Node.js.
 An example of a [web server][] written with Node.js which responds with
 `'Hello World!'`:
 
-We’ll be displaying a number of commands using a terminal, and those lines 
-
-start with `$` or `>`. You don’t need to type in the `$` and `>` character; 
-
-they are there to indicate the start of each command. 
-
-You’ll see many tutorials and examples around the web that follow this 
+Commands displayed in this document are shown starting with `$` or `>` 
+to replicate how they would appear in a user's terminal. 
+Do not include the `$` and `>` character they are there to 
+indicate the start of each command. 
 
+There are many tutorials and examples that follow this 
 convention: `$` or `>` for commands run as a regular user, and `#` 
+for commands that should be executed as an administrator. 
 
-for commands you should be running as an administrator. 
-
-Lines that don’t start with `$` or `>` are typically showing the output of
-
-the previous command.
+Lines that don’t start with `$` or `>` character are typically showing 
+the output of the previous command.
 
-Firstly, make sure you have downloaded Node.js from [Node.js Official website](http://nodejs.org/#download).
+Firstly, make sure to have downloaded Node.js from [Node.js Official website](http://nodejs.org/#download).
 
-If you want to install Node using a package manager, see [this guide](https://nodejs.org/en/download/package-manager/).
+To install Node using a package manager, see [this guide](https://nodejs.org/en/download/package-manager/).
 
 
 Now, create an empty project folder called `projects`, navigate into it:
-
-You can name your folder as you like or base on your current project title but
-
-we choose to use `projects` for the purpose of this example. 
+Project folder can be named base on user's current project title but
+this example will use `projects` as the project folder. 
 
 Linux and Mac:
 
@@ -58,20 +52,17 @@ Windows PowerShell:
 > cd $env:USERPROFILE\projects
 ```
 
-Next, create a new source file in the `projects` folder 
-
+Next, create a new source file in the `projects` folder
 and call it `hello-world.js`.
 
-If you’re using more than one word in your filename, use an hyphen (`-`) or 
-
+If filename has more than one word, use a hyphen(`-`) or 
 an underscore(`_`) to separate them for simplicity and avoid using 
-
 the space character in file names. 
 
-For example, you’d use `hello-world.js` rather than `hello world.js`.
+For example, use `hello-world.js` rather than `hello world.js`.
 Node.js files always end with the `.js` extension. 
 
-Open `hello-world.js` in your favorite text editor and paste in the following 
+Open `hello-world.js` in any preferred text editor and paste in the following 
 content.
 
 
@@ -91,19 +82,20 @@ server.listen(port, hostname, () => {
   console.log(`Server running at http://${hostname}:${port}/`);
 });
 ```
-Save the file, go back to your terminal window enter the following command:
+Save the file, go back to the terminal window enter the following command:
 
 ```txt
 $ node hello-world.js
 ```
-you should see an output like this in your terminal to indicate Node.js 
+an output like this should appear in the terminal to indicate Node.js 
 server is running:
- ```
+ ```txt
  Server running at http://127.0.0.1:3000/
  ````
- Now, open your favorite browser and visit `http://127.0.0.1:3000`.
+Now, open any preferred web browser and visit `http://127.0.0.1:3000`.
 
- You should see the string `Hello, world!`. 
+If the browser displays the string `Hello, world!`, that indicates 
+the server is working.  
 
 Many of the examples in the documentation can be run similarly.