Improve function descriptions

Author: haadcode

src/dagnode-stream.js

@@ -5,7 +5,8 @@ const streamToValue = require('./stream-to-value')
 const getDagNode = require('./get-dagnode')
 
 /*
-  Transforms a stream of objects to DAGNodes and outputs them as objects.
+  Transforms a stream of {Name, Hash} objects to include size
+  of the DAG object.
 
   Usage: inputStream.pipe(DAGNodeStream({ send: send }))
 

src/request-api.js

@@ -152,6 +152,10 @@ exports = module.exports = (config) => {
     return requestAPI(config, options, callback)
   }
 
+  // Send a HTTP request and pass via a transform function
+  // to convert the response data to wanted format before
+  // returning it to the callback.
+  // Eg. send.andTransform({}, (e) => JSON.parse(e), (err, res) => ...)
   send.andTransform = (options, transform, callback) => {
     return send(options, (err, res) => {
       if (err) {