Merge branch 'okhttp_websockets' of https://github.com/Anikate-De/http …

…into okhttp_websockets

pkgs/ok_http/README.md

@@ -29,6 +29,25 @@ This size of the [example application][] APK file using different packages:
 
 See the [OkHttp Example App][] for usage notes.
 
+## Why use `package:ok_http`?
+
+### 👍 Increased compatibility and reduced disk profile
+
+`package:ok_http` is smaller and works on more devices than other packages.
+
+This size of the [example application][] APK file using different packages:
+
+| Package | APK Size (MiB) |
+|-|-|
+| **`ok_http`** | **20.3**  |
+| [`cronet_http`](https://pub.dev/packages/cronet_http) [^1] | 20.6 |
+| [`cronet_http` (embedded)](https://pub.dev/packages/cronet_http#use-embedded-cronet) [^2] | 34.4 |
+| `dart:io` [^3] | 20.4 |
+
+[^1]: Requires [Google Play Services][], which are not available on all devices.
+[^2]: Embeds the Cronet HTTP library.
+[^3]: Accessed through [`IOClient`](https://pub.dev/documentation/http/latest/io_client/IOClient-class.html).
+
 ## Status: experimental
 
 **NOTE**: This package is currently experimental and published under the
@@ -49,3 +68,4 @@ feedback, suggestions, and comments, please file an issue in the
 [Google Play Services]: https://developers.google.com/android/guides/overview
 [WebSocket]: https://square.github.io/okhttp/5.x/okhttp/okhttp3/-web-socket/index.html
 [OkHttp Example App]: https://github.com/dart-lang/http/tree/master/pkgs/ok_http/example/
+