improve doc

Author: guyp-descope

README.md

@@ -668,9 +668,9 @@ users_history_resp = descope_client.mgmt.user.history(["user-id-1", "user-id-2"]
 
 #### Set or Expire User Password
 
-You can set (temporary/active) or expire a user's password.
-Note: When using SetTemporaryPassword password will automatically be set as expired.
-The user will not be able log-in using an expired password, and will be required replace it on next login.
+You can set a new active password for a user that they can sign in with. 
+You can also set a temporary password that they user will be forced to change on the next login.
+For a user that already has an active password, you can expire their current password, effectively requiring them to change it on the next login.
 
 ```Python
 
@@ -680,9 +680,6 @@ descope_client.mgmt.user.set_temporary_password('<login-id>', '<some-password>')
 # Set a user's password
 descope_client.mgmt.user.set_active_password('<login-id>', '<some-password>');
 
-# Set a user's password
-descope_client.mgmt.user.set_password('<login-id>', '<some-password>');
-
 # Or alternatively, expire a user password
 descope_client.mgmt.user.expirePassword('<login-id>');
 ```