Merge pull request randy3k#7 from HedenEnterprises/master

Attempting to improve the README

Author: randy3k

README.md

@@ -1,6 +1,9 @@
 # RemoteSubl
 
-RemoteSubl starts as a fork of [rsub](https://github.com/henrikpersson/rsub) to bring `rmate` feature of TextMate to Sublime Text. It transfers files to be edited from remote server using SSH port forward and transfers the files back when they are saved.
+RemoteSubl starts as a fork of [rsub](https://github.com/henrikpersson/rsub) to
+bring `rmate` feature of TextMate to Sublime Text. It transfers files to be
+edited from remote server using SSH port forward and transfers the files back
+when they are saved.
 
 Comparing to rsub, the followings are enhanced:
 
@@ -11,15 +14,22 @@ Comparing to rsub, the followings are enhanced:
 - better status bar messages when saving file and when encountering errors.
 - bring up Sublime Text on different platforms.
 
-Why a new fork? It seems that the author of rsub is not actively maintaining that package.
-
+Why a new fork? It seems that the author of rsub is not actively maintaining
+that package.
 
 # Installation
 
-RemoteSubl can easily be installed using [Package Control](https://packagecontrol.io).
+Before installing on your remote server, RemoteSubl can easily be installed
+using [Package Control](https://packagecontrol.io).
+
+Once you have that completed, open up Sublime Text *(the rest won't work unless
+you do)*.
 
-On the remote server, we need to install [rmate](https://github.com/aurora/rmate) (this one is the bash version). You don't have to install it if you have been using `rmate` with TextMate or other editors.
-It is just the same executable. If not, it (the bash version) can be installed by running this script (assume that you have the right permission),
+On the remote server, we need to install
+[rmate](https://github.com/aurora/rmate) (this one is the bash version). You
+don't have to install it if you have been using `rmate` with TextMate or other
+editors. It is just the same executable. If not, it (the bash version) can be
+installed by running this script (assuming you have the right permission),
 
 ```bash
 curl -o /usr/local/bin/rmate https://raw.githubusercontent.com/aurora/rmate/master/rmate
@@ -32,7 +42,8 @@ You can also rename the command to `rsubl`
 mv /usr/local/bin/rmate /usr/local/bin/rsubl
 ```
 
-If your remote system does not have `bash` (so what else does it have?), there are different versions of `rmate` to choose from:
+If your remote system does not have `bash` (so what else does it have?), there
+are different versions of `rmate` to choose from:
 
 - The official ruby version: https://github.com/textmate/rmate
 - A bash version: https://github.com/aurora/rmate
@@ -44,32 +55,37 @@ If your remote system does not have `bash` (so what else does it have?), there a
 
 # Usage
 
-Open an ssh connection to the remote server with remote port forwarded.
-It can be done by
+Open an ssh connection to the remote server with remote port forwarded. It can
+be done by executing the following command on your local machine:
 
 ```bash
 ssh -R 52698:localhost:52698 [email protected]
 ```
 
-After running the server, you can just open the file on the remote system by
-
-(NOTE: you need to have opened Sublime on you local machine. 
-If not you get this error connect_to localhost port 52698: failed.)
+After running the server, you can just open the file by typing the following
+command in your remote system's terminal:
 
 ```
 rmate test.txt
 ```
+
+(***NOTE:*** you need to have opened Sublime Text on your local machine.
+*If not* you get this error: `connect_to localhost port 52698: failed.` on your
+server)
+
 ... or if you renamed it to `rsubl` then ...
 
 ```
 rsubl test.txt
 ```
 
-If everything has been setup correctly, your should be able to see the opening file in Sublime Text.
+If everything has been setup correctly, you should be able to see the opening
+file in Sublime Text.
 
 ### SSH config
-It could be tedious to type `-R 52698:localhost:52698` everytime you ssh. To make your
-life easier, add the following to `~/.ssh/config`,
+
+It could be tedious to type `-R 52698:localhost:52698` everytime you ssh. To
+make your life easier, add the following to `~/.ssh/config`,
 
 ```
 Host example.com