guides/user/RPC-server.md

@@ -4,6 +4,8 @@
 
 * [Simple setup](#simple)
 * [High Performance Grid setup](#grid)
+  * [Example](#grid-example)
+  * [Mock example](#grid-mock-example)
 * [Security considerations](#security)
 * [Help output](#help)
 
@@ -17,41 +19,38 @@ This will bind on `localhost:7331` by default.
 
 In order to connect the Dispatchers into a grid you'll need to:
 
-* specify an IP address or hostname on which the Dispatcher will be accessible
-    by the rest of the Grid nodes (i.e. other Dispatchers)
-* specify a neighbouring Dispatcher when running a new one
-* use different Pipe IDs -- these are used to identify independent bandwidth
+* Specify an IP address or hostname on which the Dispatcher will be accessible
+    by the rest of the Grid nodes (i.e. other Dispatchers).
+* Specify a neighbouring Dispatcher when running a new one.
+* Use different Pipe IDs -- these are used to identify independent bandwidth
     lines to the target in order to split the workload in a way that will
-    aggregate the collective bandwidth
+    aggregate the collective bandwidth.
 
-After that they will build their network themselves.
+After that, they will build and maintain their network themselves.
 
-Here's how it's done...
+#### <a id="grid-example" href="#grid-example">Example</a>
 
-**Firing up the first one:**
+Running the first Dispatcher:
 
     arachni_rpcd --pipe-id="Pipe 1" --nickname="My Dispatcher" --address=192.168.0.1
 
-**Adding more to make a Grid:**
+Adding more in order to form a Grid:
 
     arachni_rpcd --pipe-id="Pipe 2" --nickname="My second Dispatcher" --address=192.168.0.2 --neighbour=192.168.0.1:7331
 
-**Lather, rinse, repeat:**
+Lather, rinse, repeat:
 
     arachni_rpcd --pipe-id="Pipe 3" --nickname="My third Dispatcher" --address=192.168.0.3 --neighbour=192.168.0.2:7331
-
     arachni_rpcd --pipe-id="Pipe 4" --nickname="My forth Dispatcher" --address=192.168.0.4 --neighbour=192.168.0.3:7331
 
-That sort of setup assumes that each Dispatcher is on a machine with independent
-bandwidth lines (to the target website at least).
+#### <a id="grid-mock-example" href="#grid-mock-example">Mock example</a>
 
-If you want to, out of curiosity, start a few Dispatchers on localhost you will
-need to specify the ports:
+The above setup assumes that each Dispatcher is on a machine with independent bandwidth lines
+(to the target website at least). If you want to, out of curiosity, start a few Dispatchers on
+`localhost` you will need to specify unique port numbers for them:
 
     arachni_rpcd --pipe-id="Pipe 1" --nickname="My Dispatcher"
-
     arachni_rpcd --pipe-id="Pipe 2" --nickname="My second Dispatcher" --port=1111 --neighbour=localhost:7331
-
     arachni_rpcd --pipe-id="Pipe 3" --nickname="My third Dispatcher" --port=2222 --neighbour=localhost:1111
 
 etc.