Applied readme changes based on review feedback

README.md

@@ -216,23 +216,21 @@ credentialsManager.credentials { error, credentials in
 
 #### Clearing credentials and revoking refresh tokens
 
-Credentials can be cleared by using the `clear` function, which clears credentials from memory:
+Credentials can be cleared by using the `clear` function, which clears credentials from the keychain:
 
 ```swift
 let didClear = credentialsManager.clear()
 ```
 
-In addition, credentials can be cleared and the refresh token revoked using a single call to `revoke`. This function will attempt to revoke any associated refresh token that has been stored, before clearing the credentials from memory. If revoking the token results in an error, then the credentials are not cleared.
-
-This method is asynchronous, so a callback should be specified to handle the result:
+In addition, credentials can be cleared and the refresh token revoked using a single call to `revoke`. This function will attempt to revoke the current refresh token stored by the credential manager and then clear credentials from the keychain. If revoking the token results in an error, then the credentials are not cleared:
 
 ```swift
 credentialsManager.revoke { error in
     guard error == nil else {
-        return print("Failed to clear credentials")
+        return print("Failed to revoke refresh token: \(error)")
     }
 
-    print("Credentials cleared")
+    print("Success")
 }
 ```