Specify that a real provider is highly recommended + jars

Author: slandelle

README.md

@@ -3,25 +3,61 @@ Async Http Client
 
 [Javadoc](http://www.javadoc.io/doc/com.ning/async-http-client/)
 
-Getting started [HTML](https://asynchttpclient.github.io/async-http-client/), 
-                with [WebSockets](http://jfarcand.wordpress.com/2011/12/21/writing-websocket-clients-using-asynchttpclient/)
+[Getting](https://jfarcand.wordpress.com/2010/12/21/going-asynchronous-using-asynchttpclient-the-basic/) [started](https://jfarcand.wordpress.com/2011/01/04/going-asynchronous-using-asynchttpclient-the-complex/), and use [WebSockets](http://jfarcand.wordpress.com/2011/12/21/writing-websocket-clients-using-asynchttpclient/)
 
-Async Http Client library purpose is to allow Java applications to easily execute HTTP requests and asynchronously process the HTTP responses. The library also supports the WebSocket Protocol. The Async HTTP Client library is simple to use. First, in order to add it to your Maven project, simply add this dependency:
+Async Http Client library purpose is to allow Java applications to easily execute HTTP requests and asynchronously process the HTTP responses.
+The library also supports the WebSocket Protocol. The Async HTTP Client library is simple to use.
+
+## Installation
+
+First, in order to add it to your Maven project, simply add this dependency:
 
 ```xml
 <dependency>
   <groupId>com.ning</groupId>
   <artifactId>async-http-client</artifactId>
-  <version>1.9.24</version>
+  <version>1.9.25</version>
 </dependency>
 ```
 
-Check [migration guide](MIGRATION.md) for migrating from 1.8 to 1.9.
-
 You can also download the artifact
 
 [Maven Search](http://search.maven.org)
 
+AHC is an abstraction layer that can work on top of the bare JDK, Netty and Grizzly.
+Note that the JDK implementation is very limited and you should **REALLY** use the other *real* providers.
+
+You then have to add the Netty or Grizzly jars in the classpath.
+
+For Netty:
+
+```xml
+<dependency>
+    <groupId>io.netty</groupId>
+    <artifactId>netty</artifactId>
+    <version>LATEST_NETTY_3_VERSION</version>
+</dependency>
+```
+
+For Grizzly:
+
+```xml
+<dependency>
+    <groupId>org.glassfish.grizzly</groupId>
+    <artifactId>connection-pool</artifactId>
+    <version>LATEST_GRIZZLY_VERSION</version>
+</dependency>
+<dependency>
+    <groupId>org.glassfish.grizzly</groupId>
+    <artifactId>grizzly-websockets</artifactId>
+    <version>LATEST_GRIZZLY_VERSION</version>
+</dependency>
+```
+
+Check [migration guide](MIGRATION.md) for migrating from 1.8 to 1.9.
+
+## Usage
+
 Then in your code you can simply do
 
 ```java
@@ -189,8 +225,6 @@ Keep up to date on the library development by joining the Asynchronous HTTP Clie
 
 [Google Group](http://groups.google.com/group/asynchttpclient)
 
-[![githalytics.com alpha](https://cruel-carlota.pagodabox.com/6433679063b2351599c6ca44a08246a2 "githalytics.com")](http://githalytics.com/AsyncHttpClient/async-http-client)
-
 ## Contributing
 
 Of course, Pull Requests are welcome.