feat(name): add name.resolve spec

Author: daviddias

API/name/README.md

@@ -21,7 +21,7 @@ name API
 }
 ```
 
-`callback` must follow `function (err, name) {}` signature, where `err` is an error if the operation was not successful. `name` is an object that contains the IPNS hash and the IPFS hash publishes, such as: 
+`callback` must follow `function (err, name) {}` signature, where `err` is an error if the operation was not successful. `name` is an object that contains the IPNS hash and the IPFS hash, such as: 
 
 ```JavaScript
 {
@@ -44,13 +44,30 @@ Example:
 
 ##### `Go` **WIP**
 
-##### `JavaScript` - ipfs.name.resolve(value, [options, callback])
+##### `JavaScript` - ipfs.name.resolve([options, callback])
 
-If no `callback` is passed, a promise is returned.
+`options` is an object that may contain:
+
+```JavaScript
+{
+  recursive: // bool - Resolve until the result is not an IPNS name. Default: false.
+  nocache: // bool - Do not use cached entries. Default: false.
+}
+```
 
--r, --recursive bool - Resolve until the result is not an IPNS name. Default: false.
--n, --nocache   bool - Do not use cached entries. Default: false.
+`callback` must follow `function (err, name) {}` signature, where `err` is an error if the operation was not successful. `name` is an object that contains the IPNS hash and the IPFS hash, such as: 
 
-Example:
+```JavaScript
+{
+  name: "/ipns/QmHash.."
+  value: "/ipfs/QmHash.."
+}
+```
+
+If no `callback` is passed, a promise is returned.
 
+Example:
 
+```JavaScript
+// TODO
+```