Update STATS.md

Author: hacdias

SPEC/STATS.md

@@ -11,7 +11,7 @@ Stats API
 
 #### `bw`
 
-> Adds an IPFS object to the pinset and also stores it to the IPFS repo. pinset is the set of hashes currently pinned (not gc'able).
+> Get IPFS bandwidth information as an object.
 
 ##### `Go` **WIP**
 
@@ -49,21 +49,24 @@ ipfs.stats.bw((err, stats) => console.log(stats))
 
 #### `bwPullStream`
 
-> Adds an IPFS object to the pinset and also stores it to the IPFS repo. pinset is the set of hashes currently pinned (not gc'able).
+> Get IPFS bandwidth information as an [Pull Stream][ps].
 
 ##### `Go` **WIP**
 
 ##### `JavaScript` - ipfs.stats.bwPullStream([options]) -> [Pull Stream][ps]
 
+Options are described on [`ipfs.stats.bw`](#bw).
 
 #### `bwReadableStream`
 
-> Adds an IPFS object to the pinset and also stores it to the IPFS repo. pinset is the set of hashes currently pinned (not gc'able).
+> Get IPFS bandwidth information as an [Readable Stream][rs].
 
 ##### `Go` **WIP**
 
 ##### `JavaScript` - ipfs.stats.bwReadableStream([options]) -> [Readable Stream][rs]
 
+Options are described on [`ipfs.stats.bw`](#bw).
+
 [big]: https://github.com/MikeMcl/big.js/
 [rs]: https://www.npmjs.com/package/readable-stream
 [ps]: https://www.npmjs.com/package/pull-stream