[dist] doc updates

README.md

@@ -364,7 +364,7 @@ proxyServer.listen(8015);
    * `false` (default): disable cookie rewriting
    * String: new path, for example `cookiePathRewrite: "/newPath/"`. To remove the path, use `cookiePathRewrite: ""`. To set path to root use `cookiePathRewrite: "/"`.
    * Object: mapping of paths to new paths, use `"*"` to match all paths.
-     For example keep one path unchanged, rewrite one path and remove other paths:
+     For example, to keep one path unchanged, rewrite one path and remove other paths:
      ```
      cookiePathRewrite: {
        "/unchanged.path/": "/unchanged.path/",
@@ -376,7 +376,7 @@ proxyServer.listen(8015);
 *  **proxyTimeout**: timeout (in millis) for outgoing proxy requests
 *  **timeout**: timeout (in millis) for incoming requests
 *  **followRedirects**: true/false, Default: false - specify whether you want to follow redirects
-*  **selfHandleRequest** true/false, if set to true, none of the webOutgoing passes are called and its your responsibility ro appropriately return the response by listening and acting on the `proxyRes` event
+*  **selfHandleResponse** true/false, if set to true, none of the webOutgoing passes are called and it's your responsibility to appropriately return the response by listening and acting on the `proxyRes` event
 *  **buffer**: stream of data to send as the request body.  Maybe you have some middleware that consumes the request stream before proxying it on e.g.  If you read the body of a request into a field called 'req.rawbody' you could restream this field in the buffer option:
 
     ```
@@ -486,12 +486,15 @@ proxy.close();
 
 ### Miscellaneous
 
-If you want to handle your own response after receiving the proxyRes, you can do
-so with `selfHandleResponse`
+If you want to handle your own response after receiving the `proxyRes`, you can do
+so with `selfHandleResponse`. As you can see below, if you use this option, you
+are able to intercept and read the `proxyRes` but you must also make sure to
+reply to the `res` itself otherwise the original client will never receive any
+data.
 
 ### Modify response
 
-```
+```js
 
     var option = {
       target: target,