docs: add pool.end() documentation

closes #911
closes #912

Author: Dan Bernardic

Readme.md

@@ -364,6 +364,22 @@ pool.on('enqueue', function () {
 });
 ```
 
+## Closing all the connections in a pool
+
+When you are done using the pool, you have to end all the connections or your
+script will hang until the db server closes them. To end all the connections
+in the pool, use the `end` method on the pool:
+
+```js
+pool.end(function (err) {
+  // all connections in the pool have ended
+});
+```
+
+The `end` method takes an _optional_ callback that you can use to know once
+all the connections have ended. The connections end _gracefully_, so all
+pending queries will still complete and the time to end the pool will vary.
+
 ## PoolCluster
 
 PoolCluster provides multiple hosts connection. (group & retry & selector)