diff --git a/README.md b/README.md
index 6a06df7858..3488979f70 100644
--- a/README.md
+++ b/README.md
@@ -119,6 +119,34 @@ Minimal parsing is done on the replies.  Commands that return a single line repl
 integer replies return JavaScript Numbers, "bulk" replies return node Buffers, and "multi bulk" replies return a
 JavaScript Array of node Buffers.  `HGETALL` returns an Object with Buffers keyed by the hash keys.
 
+### Commands with Optional and Keyword arguments
+
+This applies to anything that uses an optional `[WITHSCORES]` or `[LIMIT offset count]` in the [redis.io/commands](http://redis.io/commands) documentation.
+
+Example:
+```js
+var args = [ 'myzset', 1, 'one', 2, 'two', 3, 'three', 99, 'ninety-nine' ];
+client.zadd(args, function (err, response) {
+    if (err) throw err;
+    console.log('added '+response+' items.');
+
+    // -Infinity and +Infinity also work
+    var args1 = [ 'myzset', '+inf', '-inf' ];
+    client.zrevrangebyscore(args1, function (err, response) {
+        if (err) throw err;
+        console.log('example1', response);
+        // write your code here
+    });
+
+    var max = 3, min = 1, offset = 1, count = 2;
+    var args2 = [ 'myzset', max, min, 'WITHSCORES', 'LIMIT', offset, count ];
+    client.zrevrangebyscore(args2, function (err, response) {
+        if (err) throw err;
+        console.log('example2', response);
+        // write your code here
+    });
+});
+
 # API
 
 ## Connection Events