Upgrade guide and compat reports (#744)

Author: samtstern

README.md

@@ -12,6 +12,7 @@ A compatible FirebaseUI client is also available for [iOS](https://github.com/fi
 
   1. [Usage](#usage)
   1. [Installation](#installation)
+  1. [Upgrading](#upgrading)
   1. [Dependencies](#dependencies)
   1. [Sample App](#sample-app)
   1. [Contributing](#contributing)
@@ -57,6 +58,13 @@ required.
 
 After the project is synchronized, we're ready to start using Firebase functionality in our app.
 
+## Upgrading
+
+If you are using an old version of FirebaseUI and upgrading, please see the appropriate
+migration guide:
+
+  * [Upgrade from 1.2.0 to 2.0](./docs/upgrade-to-2.0.md)
+
 ## Dependencies
 
 ### Compatibility with Firebase / Google Play Services Libraries

auth/README.md

@@ -56,17 +56,6 @@ dependencies {
 }
 ```
 
-and add the Fabric repository
-
-```groovy
-allprojects {
-    repositories {
-        // ...
-        maven { url 'https://maven.fabric.io/public' }
-    }
-}
-```
-
 ### Identity provider configuration
 
 In order to use either Google, Facebook or Twitter accounts with your app, ensure that
@@ -75,6 +64,7 @@ these authentication methods are first configured in the Firebase console.
 FirebaseUI client-side configuration for Google sign-in is then provided
 automatically by the
 [google-services gradle plugin](https://developers.google.com/android/guides/google-services-plugin).
+
 If support for Facebook Login is also required, define the
 resource string `facebook_application_id` to match the application ID in
 the [Facebook developer dashboard](https://developers.facebook.com):
@@ -102,6 +92,17 @@ Twitter app as reported by the [Twitter application manager](https://apps.twitte
 In addition, you must enable the "Request email addresses from users" permission
 in the "Permissions" tab of your Twitter app.
 
+In order to resolve the Twitter SDK, add the following repository to your `build.gradle`:
+
+```groovy
+allprojects {
+    repositories {
+        // ...
+        maven { url 'https://maven.fabric.io/public' }
+    }
+}
+```
+
 ## Using FirebaseUI for Authentication
 
 Before invoking the FirebaseUI authentication flow, your app should check
@@ -175,6 +176,7 @@ startActivityForResult(
         .createSignInIntentBuilder()
         .setAvailableProviders(
                 Arrays.asList(new AuthUI.IdpConfig.Builder(AuthUI.EMAIL_PROVIDER).build(),
+                              new AuthUI.IdpConfig.Builder(AuthUI.PHONE_VERIFICATION_PROVDER).build(),
                               new AuthUI.IdpConfig.Builder(AuthUI.GOOGLE_PROVIDER).build(),
                               new AuthUI.IdpConfig.Builder(AuthUI.FACEBOOK_PROVIDER).build(),
                               new AuthUI.IdpConfig.Builder(AuthUI.TWITTER_PROVIDER).build()))
@@ -222,6 +224,18 @@ startActivityForResult(
     RC_SIGN_IN);
 ```
 
+If you'd like to keep SmartLock's "hints" but disable the saving/retrieving of credentials, then
+you can use the two-argument version of `setIsSmartLockEnabled`:
+
+```java
+startActivityForResult(
+    AuthUI.getInstance()
+        .createSignInIntentBuilder()
+        .setIsSmartLockEnabled(false, true)
+        .build(),
+    RC_SIGN_IN);
+```
+
 #### Handling the sign-in response
 
 ##### Response codes