update readme (#195)
* update readme
* address comments
diff --git a/packages/device_info/README.md b/packages/device_info/README.md
index bf7c683..5652697 100644
--- a/packages/device_info/README.md
+++ b/packages/device_info/README.md
@@ -1,20 +1,28 @@
# device_info
-This Flutter plugin provides an API for querying information about the device
-on which a Flutter application is running.
+Get current device information from within the Flutter application.
# Usage
-Import `package:device_info` and use the provided top-level functions.
+Import `package:device_info/device_info.dart`, instantiate `DeviceInfoPlugin`
+and use the Android and iOS getters to get platform-specific device
+information.
Example:
```dart
-import 'package:device_info';
+import 'package:device_info/device_info.dart';
-var androidOSBuild = await androidOSBuild;
+DeviceInfoPlugin deviceInfo = new DeviceInfoPlugin();
+AndroidDeviceInfo androidInfo = await deviceInfo.androidInfo;
+print('Running on ${androidInfo.model}'); // e.g. "Moto G (4)"
+
+IosDeviceInfo iosInfo = await deviceInfo.iosInfo;
+print('Running on ${iosInfo.model}'); // e.g. "iPhone 6"
```
+You will find links to the API docs on the [pub page](https://pub.dartlang.org/packages/device_info).
+
## Getting Started
For help getting started with Flutter, view our online
