Adds interceptors comparison to the documentation

Author: emileber

README.md

@@ -1,7 +1,6 @@
 # axios-middleware
 
 [![Build Status](https://travis-ci.org/emileber/axios-middleware.svg?branch=master)](https://travis-ci.org/emileber/axios-middleware)
-[![Dependency Status](https://beta.gemnasium.com/badges/github.com/emileber/axios-middleware.svg)](https://beta.gemnasium.com/projects/github.com/emileber/axios-middleware)
 [![npm version](https://badge.fury.io/js/axios-middleware.svg)](https://www.npmjs.com/package/axios-middleware)
 
 Simple [axios](https://github.com/axios/axios) HTTP middleware service.
@@ -42,7 +41,7 @@ service.register({
 });
 
 // We're good to go!
-export default { service };
+export default service;
 ```
 
 A common use-case would be to expose an instance of the service which consumes an _axios_ instance configured for an API. It's then possible to register middlewares for this API at different stages of the initialization process of an application.

docs/README.md

@@ -11,6 +11,18 @@ There are two classes exposed in this module:
 
 It works with either the global axios or a local instance.
 
+## Why not use interceptors?
+
+Using axios interceptors makes the code tightly coupled to axios and harder to test.
+
+This middleware service module:
+
+- offers more functionalities (e.g. see [`onSync`](api/HttpMiddleware?id=onsyncpromise))
+- looser coupling to axios
+- really easy to test middleware classes
+
+It improves readability and reusability.
+
 ## Examples
 
 All examples are written using ES6 syntax but you can definitely use this plugin with ES5 code, even directly in the browser.
@@ -45,6 +57,6 @@ service.register({
 });
 
 // We're good to go!
-export default { service };
+export default service;
 ```