Update README for newbies

* Prepare ringpop for development.
* Update the max open file limit (needed in default settings of OSX).
* Introduce tick-cluster to the README.

README.md

@@ -5,12 +5,34 @@ and provides request forwarding as a routing convenience. It can be used to
 shard your application in a way that's scalable and fault tolerant.
 
 # Installation
-To install Ringpop:
+To install Ringpop for usage as a library:
 
 ```
 npm install ringpop
 ```
 
+Prepare the current directory for development:
+
+```
+npm install
+```
+
+To be able to run the tests, make sure you have your open file limit
+restriction on at least 4K:
+
+```
+ulimit -n 4096
+```
+
+# Tick Cluster
+An example application `scripts/tick-cluster.js` is included to this
+repository. It just launches a ringpop cluster of a given size. Using this
+application is the quickest way to start a ringpop cluster.
+
+```
+./scripts/tick-cluster.js --interpreter node main.js
+```
+
 # Example
 Run a 2-node Ringpop cluster from the command-line. Install Ringpop
 and TChannel, copy/paste the below into your editor and run!

scripts/tick-cluster.js

@@ -561,7 +561,7 @@ function send(host, arg1, arg2, arg3, callback) {
 program
     .version(require('../package.json').version)
     .option('-n <size>', 'Size of cluster. Default is ' + procsToStart + '.')
-    .option('-i, --interpreter <interpreter>', 'Interpreter that runs program.')
+    .option('-i, --interpreter <interpreter>', 'Interpreter that runs program. Usually `node`.')
     .option('--interface <address>', 'Interface to bind ringpop instances to.')
     .option('--port <num>', 'Starting port for instances.')
     .arguments('<program>')