commit b9b0dc7157dcbe5c231258ab37bf1781ecb1972e
author Robert Walsh <RobertWalsh@users.noreply.github.com> Wed Nov 09 19:37:54 2016 -0600
committer GitHub <noreply@github.com> Wed Nov 09 19:37:54 2016 -0600
tree d15e66456511526db4edce4ab27815fe32b7a226
parent 9af775e6ac7e8521a1543cbb97a650349f613e2b

Update README.md

README.md

diff --git a/README.md b/README.md
index a21f724..dac9b75 100644
--- a/README.md
+++ b/README.md
@@ -276,7 +276,7 @@
 })
 ```
     
-## Authentication, current user, and auth-mode
+## Authentication, current user, and authMode
 
 ### appAuth and authenticateApp()
 
@@ -315,7 +315,13 @@
 
 ### authMode
 
-Auth-mode defines what the client should do when a user token is not present. By default, `Usergrid.authMode` is set to `UsergridAuth.AUTH_MODE_NONE`, whereby when a token is *not* present, an API call will be performed unauthenticated. If instead `Usergrid.authMode` is set to `UsergridAuth.AUTH_MODE_APP`, the API call will instead be performed using client credentials, _if_ they're available (i.e. `authenticateApp()` was performed at some point). 
+Auth-mode is used to determine what the `UsergridClient` will use for authorization.
+
+By default, `Usergrid.authMode` is set to `UsergridAuth.AUTH_MODE_USER`, whereby if a non-expired `UsergridUserAuth` exists in `UsergridClient.currentUser`, this token is used to authenticate all API calls.
+
+If instead `Usergrid.authMode` is set to `UsergridAuth.AUTH_MODE_NONE`, all API calls will be performed unauthenticated. 
+
+If instead `Usergrid.authMode` is set to `UsergridAuth.AUTH_MODE_APP`, all API calls will be performed using the client credentials token, _if_ they're available (i.e. `authenticateApp()` was performed at some point). 
 
 ### usingAuth()