Initial README for the WebView plugin (#930)
diff --git a/packages/webview_flutter/README.md b/packages/webview_flutter/README.md
index ced7b12..948d90d 100644
--- a/packages/webview_flutter/README.md
+++ b/packages/webview_flutter/README.md
@@ -1,7 +1,31 @@
-# webview_flutter
+# WebView for Flutter (Developers Preview)
[](https://pub.dartlang.org/packages/webview_flutter)
-A WebView Plugin for Flutter.
+A Flutter plugin that provides a WebView widget.
-**This is an unpublished preview.**
+On iOS the WebView widget is backed by a [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview);
+On Android the WebView widget is backed by a [WebView](https://developer.android.com/reference/android/webkit/WebView).
+
+## Developers Preview Status
+The plugin relies on Flutter's new mechanism for embedding Android and iOS views.
+As that mechanism is currently in a developers preview, this plugin should also be
+considered a developers preview.
+
+Known issues are tagged with the [platform-views](https://github.com/flutter/flutter/labels/a%3A%20platform-views) and/or [webview](https://github.com/flutter/flutter/labels/p%3A%20webview) labels.
+
+To use this plugin on iOS you need to opt-in for the embedded views preview by
+adding a boolean property to the app's `Info.plist` file, with the key `io.flutter.embedded_views_preview`
+and the value `YES`.
+
+## Setup
+
+### iOS
+Opt-in to the embedded views preview by adding a boolean property to the app's `Info.plist` file
+with the key `io.flutter.embedded_views_preview` and the value `YES`.
+
+## Usage
+Add `webview_flutter` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).
+
+You can now include a WebView widget in your widget tree.
+See the WebView widget's Dartdoc for more details on how to use the widget.
