Added more information to the README.

Author: artob

README.md

@@ -11,6 +11,15 @@ This is a [Flutter](https://flutter.io/) plugin that bundles and wraps
 an open-source extension to [SQLite](https://www.sqlite.org) that provides
 transparent 256-bit AES encryption of database files.
 
+Features
+--------
+
+- Implements fully-encrypted SQLite databases stored on disk or in memory.
+
+- Provides a high-fidelity subset of the
+  [`android.database.sqlite`](https://developer.android.com/reference/android/database/sqlite/package-summary)
+  API to aid Android developers migrating to Flutter.
+
 Compatibility
 -------------
 
@@ -30,6 +39,50 @@ var cursor = await db.rawQuery("SELECT 1 AS a, 2 as b, 3 AS c", []);
 await DatabaseUtils.dumpCursor(cursor);
 ```
 
+Frequently Asked Questions
+--------------------------
+
+### Which releases of SQLite and SQLCipher does this plugin bundle?
+
+SQLCipher for Android 3.5.9, SQLCipher 3.4.2, and SQLite 3.20.1.
+
+### Why use this plugin instead of another plugin wrapping Android's native SQLite support?
+
+Two good reasons are:
+
+1. **Encryption**.
+   Android's native SQLite support does not feature database encryption.
+   By using this plugin, you can trivially enable encryption for your app
+   database, something likely appreciated by both you as well as your users.
+
+2. **Compatibility**.
+   Android's native SQLite version
+   [varies](https://developer.android.com/reference/android/database/sqlite/package-summary)
+   greatly depending on the Android release, from SQLite 3.4 (released in
+   2007) to SQLite 3.19 (released in 2017, bundled in Android 8.1). Further,
+   some device manufacturers include different versions of SQLite on their
+   devices. By using this plugin, you gain a consistent, predictable, and
+   up-to-date version of SQLite for your app regardless of the Android
+   release your app runs on.
+
+### How much does using this plugin increase my final app size?
+
+Due to the bundled SQLCipher libraries, your APK size increases by about
+7 MiB. We are investigating potential ways (e.g., ProGuard) to reduce that.
+
+Caveats
+-------
+
+- **At present, iOS is not supported.**
+  This may eventually be addressed going forward by bundling
+  [FMDB](https://github.com/ccgus/fmdb) which includes SQLCipher support.
+
+- **At present, cursors are fully materialized.**
+  This means that queries which return very large result sets will incur
+  nontrivial overhead in the IPC transfer of the cursor data from Java to
+  Dart. We are planning to add windowed cursor and streaming support in a
+  future release. In the meanwhile, `OFFSET` and `LIMIT` are your friends.
+
 Reference
 ---------
 
@@ -61,25 +114,3 @@ Reference
     import 'package:flutter_sqlcipher/sqlcipher.dart';
 
 - [`SQLCipher.version`](https://pub.dartlang.org/documentation/flutter_sqlcipher/latest/sqlcipher/SQLCipher/version.html)
-
-Frequently Asked Questions
---------------------------
-
-### Why use this plugin instead of a plugin wrapping Android's native SQLite support?
-
-Two good reasons are:
-
-1. **Encryption**.
-   Android's native SQLite support does not support database encryption.
-   By using this plugin, you can trivially enable encryption for your app
-   database, something likely appreciated by both you as well as your users.
-
-2. **Compatibility**.
-   Android's native SQLite version
-   [varies](https://developer.android.com/reference/android/database/sqlite/package-summary)
-   greatly depending on the Android release, from SQLite 3.4 (released in
-   2007) to SQLite 3.19 (released in 2017, bundled in Android 8.1). Further,
-   some device manufacturers include different versions of SQLite on their
-   devices. By using this plugin, you gain a consistent, predictable, and
-   up-to-date version of SQLite for your app regardless of the Android
-   release your app runs on.