One more pass of feedback

Author: avolkovi

docs-exp/auth-types.auth.md

@@ -35,5 +35,5 @@ export interface Auth
 |  [signOut()](./auth-types.auth.signout.md) | Signs out the current user. |
 |  [updateCurrentUser(user)](./auth-types.auth.updatecurrentuser.md) | Asynchronously sets the provided user as <code>currentUser</code> on the Auth instance. A new instance copy of the user provided will be made and set as currentUser.<!-- -->This will trigger [Auth.onAuthStateChanged()](./auth-types.auth.onauthstatechanged.md) and [Auth.onIdTokenChanged()](./auth-types.auth.onidtokenchanged.md) listeners like other sign in methods.<!-- -->The operation fails with an error if the user to be updated belongs to a different Firebase project. |
 |  [useDeviceLanguage()](./auth-types.auth.usedevicelanguage.md) | Sets the current language to the default device/browser preference. |
-|  [useEmulator(url)](./auth-types.auth.useemulator.md) | Modify this Auth instance to communicate with the Firebase Auth emulator. This must be called synchronously immediately following the first call to <code>firebase.auth()</code>. Do not use with production credentials as emulator traffic is not encrypted. |
+|  [useEmulator(url)](./auth-types.auth.useemulator.md) | Modify this Auth instance to communicate with the Firebase Auth emulator. This must be called synchronously immediately following the first call to <code>initializeAuth()</code>. Do not use with production credentials as emulator traffic is not encrypted. |
 

docs-exp/auth-types.auth.onauthstatechanged.md

@@ -22,7 +22,7 @@ onAuthStateChanged(
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  nextOrObserver | [NextOrObserver](./auth-types.nextorobserver.md)<!-- -->&lt;[User](./auth-types.user.md)<!-- -->&gt; | callback triggere on change. |
+|  nextOrObserver | [NextOrObserver](./auth-types.nextorobserver.md)<!-- -->&lt;[User](./auth-types.user.md)<!-- -->&gt; | callback triggered on change. |
 |  error | ErrorFn | callback triggered on error. |
 |  completed | CompleteFn | callback triggered when observer is removed. |
 

docs-exp/auth-types.auth.onidtokenchanged.md

@@ -20,7 +20,7 @@ onIdTokenChanged(
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  nextOrObserver | [NextOrObserver](./auth-types.nextorobserver.md)<!-- -->&lt;[User](./auth-types.user.md)<!-- -->&gt; | callback triggere on change. |
+|  nextOrObserver | [NextOrObserver](./auth-types.nextorobserver.md)<!-- -->&lt;[User](./auth-types.user.md)<!-- -->&gt; | callback triggered on change. |
 |  error | ErrorFn | callback triggered on error. |
 |  completed | CompleteFn | callback triggered when observer is removed. |
 

docs-exp/auth-types.auth.useemulator.md

@@ -4,7 +4,7 @@
 
 ## Auth.useEmulator() method
 
-Modify this Auth instance to communicate with the Firebase Auth emulator. This must be called synchronously immediately following the first call to `firebase.auth()`<!-- -->. Do not use with production credentials as emulator traffic is not encrypted.
+Modify this Auth instance to communicate with the Firebase Auth emulator. This must be called synchronously immediately following the first call to `initializeAuth()`<!-- -->. Do not use with production credentials as emulator traffic is not encrypted.
 
 <b>Signature:</b>
 
@@ -16,7 +16,7 @@ useEmulator(url: string): void;
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  url | string | The URL at which the emulator is running (eg, 'http://localhost:9099') |
+|  url | string | The URL at which the emulator is running (eg, 'http://localhost:9099'). |
 
 <b>Returns:</b>
 

docs-exp/auth-types.confirmationresult.confirm.md

@@ -27,7 +27,7 @@ Promise&lt;[UserCredential](./auth-types.usercredential.md)<!-- -->&gt;
 
 ```javascript
 const confirmationResult = await signInWithPhoneNumber(auth, phoneNumber, applicationVerifier);
-// obtain verificationCode from the user
+// Obtain verificationCode from the user.
 const userCredential = await confirmationResult.confirm(verificationCode);
 
 ```

docs-exp/auth-types.md

@@ -53,7 +53,7 @@
 |  [PhoneMultiFactorEnrollInfoOptions](./auth-types.phonemultifactorenrollinfooptions.md) | Options used for enrolling a second factor. |
 |  [PhoneMultiFactorSignInInfoOptions](./auth-types.phonemultifactorsignininfooptions.md) | Options used for signing-in with a second factor. |
 |  [PhoneSingleFactorInfoOptions](./auth-types.phonesinglefactorinfooptions.md) | Options used for single-factor sign-in. |
-|  [PopupRedirectResolver](./auth-types.popupredirectresolver.md) | A resolver used for handling DOM specific operations like <code>signInWithPopup()</code> or <code>signInWithRedirect()</code> |
+|  [PopupRedirectResolver](./auth-types.popupredirectresolver.md) | A resolver used for handling DOM specific operations like <code>signInWithPopup()</code> or <code>signInWithRedirect()</code>. |
 |  [ReactNativeAsyncStorage](./auth-types.reactnativeasyncstorage.md) | Interface for a supplied AsyncStorage. |
 |  [User](./auth-types.user.md) | A user account. |
 |  [UserCredential](./auth-types.usercredential.md) | A structure containing a [User](./auth-types.user.md)<!-- -->, an [AuthCredential](./auth-types.authcredential.md)<!-- -->, the [OperationType](./auth-types.operationtype.md)<!-- -->, and any additional user information that was returned from the identity provider. <code>operationType</code> could be [OperationType.SIGN\_IN](./auth-types.operationtype.sign_in.md) for a sign-in operation, [OperationType.LINK](./auth-types.operationtype.link.md) for a linking operation and [OperationType.REAUTHENTICATE](./auth-types.operationtype.reauthenticate.md) for a reauthentication operation. |

docs-exp/auth-types.multifactorresolver.md

@@ -45,14 +45,13 @@ const phoneInfoOptions = {
   session: resolver.session
 };
 const verificationId = phoneAuthProvider.verifyPhoneNumber(phoneInfoOptions, appVerifier);
-// store `verificationId` and show UI to let user enter verification code.
+// Store `verificationId` and show UI to let user enter verification code.
 
 // UI to enter verification code and continue.
 // Continue button click handler
 const phoneAuthCredential = PhoneAuthProvider.credential(verificationId, verificationCode);
 const multiFactorAssertion = PhoneMultiFactorGenerator.assertion(phoneAuthCredential);
 const userCredential = await resolver.resolveSignIn(multiFactorAssertion);
-// User signed in.
 
 ```
 

docs-exp/auth-types.multifactoruser.enroll.md

@@ -33,7 +33,7 @@ Promise<void>
 const multiFactorUser = multiFactor(auth.currentUser);
 const multiFactorSession = await multiFactorUser.getSession();
 
-// Send verification code
+// Send verification code.
 const phoneAuthProvider = new PhoneAuthProvider(auth);
 const phoneInfoOptions = {
   phoneNumber: phoneNumber,

docs-exp/auth-types.multifactoruser.getsession.md

@@ -24,7 +24,7 @@ The promise that resolves with the [MultiFactorSession](./auth-types.multifactor
 const multiFactorUser = multiFactor(auth.currentUser);
 const multiFactorSession = await multiFactorUser.getSession();
 
-// Send verification code
+// Send verification code.
 const phoneAuthProvider = new PhoneAuthProvider(auth);
 const phoneInfoOptions = {
   phoneNumber: phoneNumber,

docs-exp/auth-types.phoneauthprovider.credential.md

@@ -34,7 +34,7 @@ The auth provider credential.
 ```javascript
 const provider = new PhoneAuthProvider(auth);
 const verificationId = provider.verifyPhoneNumber(phoneNumber, applicationVerifier);
-// obtain verificationCode from the user
+// Obtain verificationCode from the user.
 const authCredential = PhoneAuthProvider.credential(verificationId, verificationCode);
 const userCredential = signInWithCredential(auth, authCredential);
 
@@ -46,7 +46,7 @@ An alternative flow is provided using the `signInWithPhoneNumber` method.
 
 ```javascript
 const confirmationResult = await signInWithPhoneNumber(auth, phoneNumber, applicationVerifier);
-// obtain verificationCode from the user
+// Obtain verificationCode from the user.
 const userCredential = await confirmationResult.confirm(verificationCode);
 
 ```

docs-exp/auth-types.phoneauthprovider.verifyphonenumber.md

@@ -34,7 +34,7 @@ A Promise for the verification ID.
 ```javascript
 const provider = new PhoneAuthProvider(auth);
 const verificationId = await provider.verifyPhoneNumber(phoneNumber, applicationVerifier);
-// obtain verificationCode from the user
+// Obtain verificationCode from the user.
 const authCredential = PhoneAuthProvider.credential(verificationId, verificationCode);
 const userCredential = await signInWithCredential(auth, authCredential);
 
@@ -46,7 +46,7 @@ An alternative flow is provided using the `signInWithPhoneNumber` method.
 
 ```javascript
 const confirmationResult = signInWithPhoneNumber(auth, phoneNumber, applicationVerifier);
-// obtain verificationCode from the user
+// Obtain verificationCode from the user.
 const userCredential = confirmationResult.confirm(verificationCode);
 
 ```

docs-exp/auth-types.popupredirectresolver.md

@@ -4,7 +4,7 @@
 
 ## PopupRedirectResolver interface
 
-A resolver used for handling DOM specific operations like `signInWithPopup()` or `signInWithRedirect()`
+A resolver used for handling DOM specific operations like `signInWithPopup()` or `signInWithRedirect()`<!-- -->.
 
 <b>Signature:</b>
 

docs-exp/auth-types.user.getidtoken.md

@@ -6,7 +6,7 @@
 
 Returns a JSON Web Token (JWT) used to identify the user to a Firebase service.
 
-Returns the current token if it has not expired. Otherwise, this will refresh the token and return a new one.
+Returns the current token if it has not expired or if it will not expire in the next five minutes. Otherwise, this will refresh the token and return a new one.
 
 <b>Signature:</b>
 

docs-exp/auth-types.user.getidtokenresult.md

@@ -4,9 +4,9 @@
 
 ## User.getIdTokenResult() method
 
-Returns a de-serialized JSON Web Token (JWT) used to identitfy the user to a Firebase service.
+Returns a deserialized JSON Web Token (JWT) used to identitfy the user to a Firebase service.
 
-Returns the current token if it has not expired. Otherwise, this will refresh the token and return a new one.
+Returns the current token if it has not expired or if it will not expire in the next five minutes. Otherwise, this will refresh the token and return a new one.
 
 <b>Signature:</b>
 

docs-exp/auth-types.user.md

@@ -29,8 +29,8 @@ export interface User extends UserInfo
 |  Method | Description |
 |  --- | --- |
 |  [delete()](./auth-types.user.delete.md) | Deletes and signs out the user.<!-- -->Important: this is a security-sensitive operation that requires the user to have recently signed in. If this requirement isn't met, ask the user to authenticate again and then call one of the reauthentication methods like <code>reauthenticateWithCredential</code>. |
-|  [getIdToken(forceRefresh)](./auth-types.user.getidtoken.md) | Returns a JSON Web Token (JWT) used to identify the user to a Firebase service.<!-- -->Returns the current token if it has not expired. Otherwise, this will refresh the token and return a new one. |
-|  [getIdTokenResult(forceRefresh)](./auth-types.user.getidtokenresult.md) | Returns a de-serialized JSON Web Token (JWT) used to identitfy the user to a Firebase service.<!-- -->Returns the current token if it has not expired. Otherwise, this will refresh the token and return a new one. |
+|  [getIdToken(forceRefresh)](./auth-types.user.getidtoken.md) | Returns a JSON Web Token (JWT) used to identify the user to a Firebase service.<!-- -->Returns the current token if it has not expired or if it will not expire in the next five minutes. Otherwise, this will refresh the token and return a new one. |
+|  [getIdTokenResult(forceRefresh)](./auth-types.user.getidtokenresult.md) | Returns a deserialized JSON Web Token (JWT) used to identitfy the user to a Firebase service.<!-- -->Returns the current token if it has not expired or if it will not expire in the next five minutes. Otherwise, this will refresh the token and return a new one. |
 |  [reload()](./auth-types.user.reload.md) | Refreshes the user, if signed in. |
 |  [toJSON()](./auth-types.user.tojson.md) | Returns a JSON-serializable representation of this object. |
 

docs-exp/auth-types.userinfo.md

@@ -19,7 +19,7 @@ export interface UserInfo
 |  [displayName](./auth-types.userinfo.displayname.md) | string \| null | The display name of the user. |
 |  [email](./auth-types.userinfo.email.md) | string \| null | The email of the user. |
 |  [phoneNumber](./auth-types.userinfo.phonenumber.md) | string \| null | The phone number normalized based on the E.164 standard (e.g. +16505550101) for the user. This is null if the user has no phone credential linked to the account. |
-|  [photoURL](./auth-types.userinfo.photourl.md) | string \| null | The profile photo URL of the user |
+|  [photoURL](./auth-types.userinfo.photourl.md) | string \| null | The profile photo URL of the user. |
 |  [providerId](./auth-types.userinfo.providerid.md) | string | The provider used to authenticate the user. |
 |  [uid](./auth-types.userinfo.uid.md) | string | The user's unique ID, scoped to the project. |
 

docs-exp/auth-types.userinfo.photourl.md

@@ -4,7 +4,7 @@
 
 ## UserInfo.photoURL property
 
-The profile photo URL of the user
+The profile photo URL of the user.
 
 <b>Signature:</b>